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PREFACE 


0.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS 


System generation is a fairly complicated process. To understand 
fully what is taking place, you must be knowledgeable in the operation 
of RSX-11M and its component tasks. Refer to Section 0.3 below for 
further information regarding related manuals and recommended reading. 


NOTE 


Users should undertake a system 
generation only with adequate planning. 
‘This includes a thorough study of . the 
query programs in Chapter 3 and the 
answers the user will provide, so that 
the options for the Executive, 
processor, and peripherals are those 
describing the intended target system. 
In addition, a preliminary layout of 
memory partitions is essential if the 
later phases of the system generation 
process are to proceed smoothly. 


0.2 STRUCTURE OF THE DOCUMENT 


This manual provides information on how to generate an RSX-11M system 
tailored to a particular installation's hardware configuration. As 
delivered, RSX-11M includes an operational Executive, called the 
Baseline System. Section 0.4 describes the Baseline System and 
Section 2.3 describes the bootstrap procedures that the user must 
follow to load the system. 


Chapter 1 contains an overview of the system generation process. It 
acquaints you with the various phases involved in producing a tailored 
system. , a4 


Chapter 2 describes the contents of the distribution kit and provides 
information on getting started. 


The actual procedures involved in system generation are provided in 
Chapter 3. This chapter describes the step-by-step process followed 
in generating a system. . 


Chapter 4 covers procedures needed for generating larger 
multi-function systems. 


ix 


Chapter 5 describes the commands and operation of Virtual Monitor 
Console Routine (VMR), a program that initializes the target system in 
the final stage of system generation. 


The remaining sections comprise appendixes describing UIC conventions, 
RSX-11M operational hints, and a sample system generation. 


0.3 ASSOCIATED DOCUMENTS 

Other manuals closely allied to the purposes of this document are 
described briefly in the RSX-11M/RSX-11S Documentation Directory. The 
Documentation Directory defines the intended readership of each manual 


in the RSX-11M/RSX-11S set and provides a brief synopsis of each 
manual's contents. 


0.4 THE BASELINE SYSTEM 
RSX-11M services a wide range of PDP-1l hardware configurations. The 
system generation process tailors a system to a local set of hardware 
and performance requirements. 
The tailoring process is run on an RSX-11M system called the Baseline 
System. The Baseline System is a fully operational RSX-11M system 
built explicitly for generating target systems. It is not for general 
use because of the small size of the dynamic memory pool. The 
Baseline System contains the following Executive options and device 
support: 
Executive options in the Baseline System: 

Files-1l Ancillary Control Processor (FI11ACP) 

Checkpointing. 

Nonresident task support 

Address checking (mapped system only) 

I/O rundown 

External MCR functions 

Task termination and device-not-ready messages 

GET PARTITION PARAMETERS directive 

GET TASK PARAMETERS directive 

Install, request, and remove on exit support 

Logical device assignment support 


At least 400. words of dynamic memory 


Loadable Drivers 


Processor options in the Baseline System: 
For unmapped RK05 disk systems-- 
16K of memory 
For unmapped RP02/03, RP04/05/06, RK0O6, and dual RKO5 systems-- 
24K of memory 
For all mapped systems-- 
24K of memory 
Memory management unit (KT11) 
Peripheral device support in the single RKO5 disk Baseline System: 
2 RKO5 disk drives 
2 TAl1 cassette drives * 
2 TU56 DECtape drives * 
2 RX0l1 floppy disk drives * 
2 TE/TU1O or TSO3 magtape drive * 
2 TE/TU16 or TU45 magtape drive * 
1 LP1ll or LS1ll line printer * 
1 PC1ll paper tape punch * 
1 terminal 
Peripheral device support in the dual RKO5 disk Baseline System: 
4 RKO5 disk drives 
2 TA11 cassette drives * 
2 TU56 DECtape drives * 
2 RX0O1 floppy disk drives * 
2 TE/TU10 or TSO03 magtape drive * 
2 TE/TU16 or TU45 magtape drive * 
1 LP1ll or LS11 line printer * 
1 PCll paper tape punch * 


1 terminal 


* Supplied as a loadable driver with loadable data base. 
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CHAPTER 1 


INTRODUCTION TO SYSTEM GENERATION 


1.1 SYSTEM GENERATION OVERVIEW 


The object of the system generation procedure (SYSGEN) is to create an 
RSX-11M system tailored to your local hardware configuration and 
performance requirements. This chapter provides an outline of the 
stages involved in performing system generation. Chapter 3 describes 
the system generation procedures. 


The system generation process implies variability and choice. Five 
categories of choices are available: 


1. Executive service options 
2. Processor options 

3. Peripheral devices 

4. Partition configurations 
5. Member tasks 


You tailor a system to your local needs by selecting options from 
these five categories. 


1.2 FUNCTIONAL FLOW OF SYSTEM GENERATION 


SYSGEN has three separate phases. You perform a particular set of 
actions to produce specific system output for each phase. These three 
phases are: 


1. Configuring and assembling the Executive. 


2. Building the Executive and privileged tasks; setting up 
partitions, installing tasks, and bootstrapping and saving 
the new system. 


3. Building the nonprivileged utility tasks. This step is 
usually unnecessary for unmapped systems if the SYSGEN 
received adequate planning and is not necessary on a mapped 
system unless you want to build the utilities (utility tasks 
are supplied in object form). 


The entire SYSGEN process, of which the above phases are components, 
is directed by three indirect command files: SYSGEN.CMD; 
SYSGEN2.CMD; and SYSGEN3.CMD. 
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SYSGEN.CMD determines the features that will be included in the new 
system and assembles the Executive. The SYSGEN.CMD file does this by 
activating the following three query files: 


@ SGNEXEC.CMD - queries you to determine the desired executive 
service and processor options and produces the conditional 
assembly parameter file. 


e SGNPER.CMD - queries you to determine the desired peripheral 
options and creates the Executive prefix file, the build 
files, and the device database for the system that is being 
generated. 


@e SGNTT.CMD - queries you to determine the data base for the 
system's terminals. 


SYSGEN2.CMD builds the Executive and all of the privileged tasks. 


SYSGEN3.CMD builds the non-privileged utility tasks and user mode 
diagnostics. 


The dual RKO5 distribution kit uses three additional indirect command 
files: PRESYSGEN.CMD, SGNXFER.CMD, and SGNXFER2.CMD. 


PRESYSGEN.CMD - initializes the system for a dual RKO5 SYSGEN. 
The command file prepares the system disk for use 
by the other system generation programs. 
PRESYSGEN.CMD chains (invokes) the indirect 
command file SYSGEN.CMD 


SGNXFER.CMD - transfers control from SYSGEN.CMD to SYSGEN2.CMD. 
This transfer program is necessary because the 
files SYSGEN.CMD and SYSGEN2.CMD are on different 
disks. 


SGNXFER2.CMD - transfers control from SYSGEN2.CMD to SYSGEN3.CMD 
and then back to SYSGEN2.CMD. Again, the 


transfer program is necessary because the files 
are on different disks. 


1.2.1 Configuration and Assembly of the Executive 
To use the Baseline Executive, which exists on the distribution disks, 
conduct this phase by answering the questions during SYSGEN.CMD that 
are asked by the three query files (SGNEXEC, SGNPER, SGNTT). When you 
answer these questions you will determine the: . 

l. Executive service options 

2. Processor options 


3. Peripheral device set 


that will be incorporated into the Executive being created to service 
your configuration. 
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NOTE 


The indirect command file SYSGEN.CMD 
provides the means’ for specifying all 
Executive options, processor options and 
peripheral devices to be generated for 
the target system. Thus, it is 
necessary to thoroughly read Chapter 3 
and the RSX-11M Executive Reference 
Manual to know what and how to specify 
the options required in the target 
Executive. The SYSGEN.CMD file, and the 
query files it references, determine the 
processor and Executive options; also 
determined are the number and type of 
peripheral devices that are to _ be 
generated for the target system. 


Your interaction with SYSGEN.CMD and the three query files results in 
the creation of five files on the disk: 


1. RSXMC.MAC 
2. SYSTB.MAC 
3. RSXASM.CMD 
4. RSXBLD.CMD 
5. ICTAB.MAC (only if ICS/ICR-11 support is included) 


RSXMC.MAC contains the conditional assembly parameters necessary to 
produce the user-tailored Executive. 


SYSTB.MAC is a file of device table descriptions that define the 
peripheral configuration. 


RSXASM.CMD is a MACRO-1l indirect command file that directs’ the 
conditional assembly of the user-tailored Executive. RSXBLD.CMD is a 
Task Builder indirect command file that directs the building of the 
user-tailored Executive. 


ICTAB.MAC is a MACRO-11 source file that defines the module layout of 
an ICS/ICR-1l subsystem. It is generated only when you select the 
ICS/ICR-11 subsystem for inclusion in the target system. 


After the questions asked by the query files have been answered _ and 
the five output files created, the user-tailored Executive is 
assembled via the indirect command file RSXASM.CMD. The indirect MCR 
command file SYSGEN.CMD directs both the configuration, query section, 
and assembly. Thus, to initiate Phase 1: 

1. Mount the correct disk 

2. Bootstrap the Baseline System 


3. Enter the time and date 
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4. Initiate the indirect MCR command file, SYSGEN.CMD, for all 
distribution kits except the dual RKO5 kit 


5. Initiate the indirect MCR command file, PRESYSGEN.CMD, for 
dual RKO5 systems 


1.2.2 Setting Up Partitions, Building and Installing Tasks 


During Phase 2, the following tasks are built: the user-tailored 
Executive, any loadable drivers, the privileged tasks, and, under 
certain conditions, some nonprivileged system tasks. At the end of 
building the Executive, you have a nonoperational Executive, and the 
value of the symbol $SYTOP is known. 


The symbol SSYTOP represents the address of the last word in the 
user-tailored Executive, which enables you to determine the size of 
the Executive. A complete, operational system consists of: 


1. An Executive 

2. Resident and loadable drivers 

3. Privileged and nonprivileged system tasks 
4. User tasks 


5. A set of memory partitions into which tasks can be installed 
and run 


Having the value of $SYTOP, you can divide memory into the partitions 
and subpartitions needed to meet the application and performance 
requirements of the system. 


The indirect MCR command file SYSGEN2.CMD controls this phase. Once 
you initiate SYSGEN2.CMD, it guides you through the building and 
installation of requisite tasks. On all kits except the single RKO5 
or the RLO1 kit, SYSGEN3.CMD can be called directly by SYSGEN2.CMD to 
build the utility tasks. On single RKO5 or RLO1 kits, SYSGEN3.CMD is 
Supplied on the utility disk, and must be run separately. 


The building of privileged and nonprivileged system tasks occurs after 
you established partition boundaries, because these tasks ultimately 
execute in these partitions. 


Using virtual MCR (VMR) and the disk image of the target system, you 
can now establish the partitions and install the tasks needed to 
complete the operational system. 


Having created the operational system, complete with partitions and 
tasks, you now must bootstrap the system, using the MCR BOOT command, 
and then save the system, using the MCR SAVE command with the /WB 
Switch appended. MCR saves the system and then automatically re-boots 
it. 


The indirect command file, SYSGEN2.CMD, directs VMR processing to set 
partitions, install tasks, bootstrap and save the system. 


For SYSGENs using a single RKO5 kit or an RLO1l kit, nonprivileged 
tasks cannot be built on the related object disk because of space 
limitations. The utility object disk contains all the files needed to 
build the nonprivileged tasks and the indirect command file 
SYSGEN3.CMD to direct the process. 
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For SYSGENS using any other kits, SYSGEN2.CMD directly calls 
SYSGEN3.CMD. 


On all kits, SYSGEN3.CMD may be run separately at a later time. 


1.3 DIFFERENCE BETWEEN MAPPED AND UNMAPPED SYSTEM 


RSX-11M runs on all models of the PDP-11l processor except the LSI-11 
or PDP-11/03. The basic addressing scheme of the processor 
instructions allows direct addressing of up to 32K words (64K bytes) 
of memory. Note the 4K words are reserved for UNIBUS I/0 device 
registers (see the appropriate Processor Handbook). To use memories 
larger than 28K words, the memory management unit (KT11) must be 
present. It is available on the PDP-11/34/35/40/45/50/55/60/70. This 
unit maps a task's virtual address (0-32K words) into a physical 
memory address (0-124K words except on the PDP-11/70, which may be 
expanded to 1920K words). 


On an unmapped system, tasks must be linked to the physical base 
address of the partition in which they run; however, in a mapped 
system, all tasks are mapped with the kKTll, and the virtual base 
address of the task is usually zero. To run a task built for an 
unmapped system in a partition with a different base address, the task 
must be rebuilt to link it to the physical base address of the new 
partition. This is not necessary on a mapped system, because the 
physical base address of the partition is determined by the KTIll. 
Thus, any task on a mapped system can be run in any partition large 
enough to accommodate it, whether or not it is the partition for which 
the task was built. This affects the SYSGEN procedure, because 
altering the partitions in an unmapped system can force you to rebuild 
all the utility tasks, whereas, in a mapped system, this does not 
happen. 


CHAPTER 2 
GETTING STARTED 


2.1 CONTENTS OF THE DISTRIBUTION KITS 
Each RSX-11M V3.1 distribution kit contains a system that can be 
bootstrapped. This system can run on the minimum configuration for 
which it is intended. All system components required to run _ and 
generate custom tailored systems are included in the kits. We 
distribute RSX-11M in 11 different kits: 

1. Six RKO5 disks (single RKO5 kit) 

2. Five RKO5 disks (dual RKO5S kit) 

3. One RKO6 disk 

4. Three RLO1 disks 


5. Six 600-foot 800-BPI tapes containing DSC images of the six 
RKO5 disks in one above 


6. Five 600-foot 800-BPI tapes containing DSC images of the five 
RKO5 disks in two above 


7. Three 600-foot 800-BPI tapes containing DSC images of an RK06 
disk 


8. Three 600-foot 800-BPI tapes containing DSC images of three 
RLO1 disks 


9. Three 600-foot 800-BPI tapes containing DSC images of an RMO3 
disk 


10. Three 600-foot 800-BPI tapes containing DSC images of an 
RP02/03 disk 


ll. Three 600-foot 800-BPI tapes containing DSC images of a 
RP04/05/06 disk 


In addition, all tape kits contain an additional 600-foot, 800-BPI 


tape with a bootable, stand-alone copy of the Disk Save and Compress 
(DSC) utility. 


2.1.1 Single RKO5 Release Kits - Summary 


2.1.1.1 Summary of Single RKO5 Disk Release Kit Contents - The 
distribution kit contains six RKO5 disk cartridges identified as: 


1. Executive source Disk - EXCSRC1 
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2. Unmapped object Disk -— UNMOBJ 

3. Mapped object Disk ~- MAPOBJ 

4. MCR source Disk - MCRSRC 

5. FCP and DMP source disk - FCPDMP 
6. Utility object disk - UTLOBJ1 


For generating mapped or unmapped systems, two or three of these disks 
are used -- the Executive source disk, the applicable object disk, and 
possibly the utility object disk. If you are building a mapped 
system, your system must have a minimum of 24K of memory and a Memory 
Management Unit. The MCRSRC, and FCPDMP source disks are used if you 
want to modify MCR or FCP. The DMP sources are included as an example 
of how a typical MCR utility program is written. DMP is on the FCPDMP 
source disk. 


The first phase of SYSGEN uses the Executive source disk. 
Among its files are: 
1. The Baseline System Executive and loadable drivers 
2. A subset of the system tasks 
3. Complete source code for the Executive 


4. The system generation indirect MCR command files SYSGEN.CMD 
SYSGENO.CMD, SGNEXEC.CMD, SGNPER.CMD, and SGNTT.CMD. 


Output files created during the first phase of system generation are 
generated on the Executive source disk. 


The object disk (mapped or unmapped) is used for the second phase of 
SYSGEN and contains among its files: 


1. The Baseline System Executive, loadable drivers, and system 
tasks. The unmapped object disk contains a 16K unmapped 
Baseline System and the object libraries for an unmapped MCR 
and FCP. The mapped object disk contains a 24K mapped 
Baseline System and the object libraries for a mapped MCR and 
FCP. 


2. Task-build command files to create all privileged system 
tasks 


3. Object library files for all privileged system tasks 


4. The system generation indirect MCR command file, SYSGEN2.CMD, 
SYSGEN2A.CMD, and BLDDRV.CMD 


In addition, the following files, created on the Executive source disk 
during phase 1, are copied to the object disk: the concatenated 
Executive object file RSX11M.OBJ, the SYSGEN parameter file 
SGNPARM.CMD, the Executive task-build command file RSXBLD.CMD, and the 
ICS/ICR-~1l1 table module ICTAB.MAC. The latter part of SYSGEN creates 
the user-tailored Executive on the object disk, which ultimately 
becomes your system disk. 


GETTING STARTED 
To obtain a detailed list of the contents of the disks, use _ the 
following commands: 


>RUN SPIP 
PIP>DKO: [*,*]/LI 


This command sequence produces, on the console terminal, a complete 
directory listing of the volume mounted on DKO0:. 


2.1.1.2 Summary of Single RKO5 Magtape Release Kit Contents - The 
release kit consists of seven 600-foot, 9-track, 800-BPI magtapes. 
The magtapes each contain one of six RKO5 disk images and a_ seventh 
tape contains a stand-alone version of DSC. The six images correspond 
to the six disks described earlier. The disk images on each magnetic 
tape are: 

1. Executive source tape containing the file EXCSRC1 

2. The unmapped object tape containing the file UNMOBJ 

3. The mapped object tape containing the file MAPOBJ 

4. MCR source tape contains the file MCRSRC 

5. FCP and DMP tape containing the file FCPDMP 

6. Utility object tape containing the file UTLOBJ1 
Before beginning a SYSGEN, you must copy the files that you need from 


these tapes onto RKO5 cartridges using the Disk Save and Compress 
utility (DSC). Section 2.2.3.5 contains an example of using DSC. 


2.1.2 Single RKO5 Release Kits - Details 


2.1.2.1 Executive Source Disk Contents - The Executive source disk 
contains the following: 


UIC CONTENTS 
{1,1] System and Executive macro libraries 
[1,2] Error message text file, startup command file 
[1,50] Baseline unmapped Executive and tasks required for 

SYSGEN 

[11,10] Executive source modules 
[11,20] Directory for unmapped Executive object modules 
[11,24] Directory for mapped Executive object modules 
[11,40] Directory for Executive correction files 
[200,200] SYSGENO.CMD, SYSGEN.CMD, SGNEXEC.CMD, SGNPER.CMD, 


SGNTT.CMD and RSXMC.MAC for the baseline system. 


The RSX-11M system files distributed on this disk provide a limited number of 
tasks. 


utility 


GETTING STARTED 


The tasks are: 


BOO ~- MCR BOOT command 

DMO - MCR DISMOUNT command 

IND - MCR indirect command file processor 
INI - MCR Disk Initialization command 

INS - MCR INSTALL command 

LOA - MCR LOAD command 

MCR - Monitor console routine 

MOU - MCR MOUNT command 

SAV - MCR SAVE command 

TKN - Task termination notification routine 
UFD - MCR User File Directory command 

UNL - MCR UNLOAD command 

FCPNMH - 2K non-multi-header file system 

PIP - Peripheral Interchange Program 

FLX - File exchange program 

BIGMAC - 14K MACRO-11 assembler 

MAC - 8K MACRO-11 assembler 

EDI - Line text editor 

SLP - Source Language Input Program 

VFY - File Structure Verification Program 


The partition layout for the system on the source disk is’ shown 
Figure 2-1. 


22K 130000(8) 
UNASSIGNED 
(6K) 
16K PARI4K 100000(8) 
Partition 
(14K) 
GEN 
Subpartition 
(8K) 
8K 40000(8) 


SYSPAR Partition 


30100(8) 
SECPAR Partition 


25200(8) 
DSKPAR Partition 
24400(8) 
Executive 
0 


Figure 2-1 Baseline Single RKO5 Unmapped System Partition Layout 
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This system runs on a processor with 16K of memory or more. The 
assembler uses the subpartition GEN on 16K systems, and partition 
PAR14K on systems with at least 22K of memory. If you want Executive 
listings on a 16K system, two assemblies are recommended -- one to 
produce the object modules, and one to produce the listings. On 
systems with more than 16K of memory, this restriction does not exist. 


You must not use the PAR14K partition to run tasks on a 16K machine, 
because it maps into 6K of nonexistent memory. Devices generated into 
this system are: 


2 RKOS drives 
1 terminal 


In addition, loadable drivers with loadable data bases are provided 
for the following: 


TC11/TU56 DECtape drives 

TA11/TU60 Cassette drives 

RX11/RX01 Floppy disk drives 

TM11/TMA11/TMB11 - TU10/TSO3/TE10 magtape drive 
RH11/RH70/TM02/03 - TU16/TU45/TE16 magtape drive 
PCll Paper Tape punch 
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2.1.2.2 Unmapped Object Disk Contents - The unmapped object disk 
contains the following: 


UIC CONTENTS 


{1,1] System object library, Executive symbol definition 
library, ODT and TRACE object modules; concatenated 
object module files for the FORTRAN Purdue ISA 
Routines, and a concatenated object module file 
containing FCS routines for ANSI magtape support 


[E24 Error message text file, startup command file 

[1,3] Directory for lost files found by VFY 

[1,4] Directory for Snap-Shot and Post-Mortem Dumps 

[1,6] Directory for Error Log files 

[1,20] Object module libraries, task-build command files, 


overlay description files for all DEC-supplied 
privileged tasks, and overlay description and 
task-build command files for nonprivileged system tasks 


[1,30] Directory for task maps 


[1,50] RSX-11M Baseline System Executive and all DEC-supplied 
tasks built to run with the Baseline System Executive 


[1,60] Directory for RSX-11S Executive and tasks 


[200,200] SYSGEN2.CMD, BLDDRV.CMD, and SYSGEN2A.CMD command 
files, and source module for building resident file 
control services (FCS) and FORTRAN Object Time System 
(OTS) libraries 
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The partition layout and device configuration of the system that is 
distributed on the unmapped object disk is identical to that of the 
source disk. Use the unmapped object disk to build a new, unmapped 
RSX-11M system to your specifications. 


2.1.2.3 Mapped Object Disk Contents - The mapped object disk contains 
the following: 


UIC CONTENTS 


[1,1] System object library, Executive symbol definition 
library, ODT and TRACE object modules, concatenated 
object module files for the FORTRAN Purdue ISA 
routines, and a concatenated object module file 
containing FCS routines for ANSI magtape support 


[1,2] Error message text file, startup command file 

{1,3] Directory for lost files found by VFY 

[1,4] Directory for Snap-Shot and Post-Mortem Dumps 

[1,6] Directory for Error Log files 

[1,20] Object module libraries and overlay descriptor files 


for all nonprivileged system tasks 


[1,24] Object module libraries and overlay description files 
for all privileged tasks, task-build command files for 
all tasks not distributed or built under UIC [1,54] 


[1,34] Directory for task maps 


[1,54] RSX-11M mapped 24K Baseline System Executive and all 
DEC-supplied tasks built to run with the Executive 


[1,64] Directory for RSX-11S Executive and tasks 


[200,200] SYSGEN2.CMD and BLDDRV.CMD command files, and _ source 
module for building resident file control services 
(FCS) and FORTRAN Object Time System libraries 


The device configuration for this system is identical to that of the 
system on the source disk. The partition layout appears in Figure 
2-2. 
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24K 140000(8) 
UNASSIGNED 
(6K) 
PAR14K 
18K Partition 110000(8) 
(14K) 
GEN 
Subpartition 
(8K) 
50000(8) 
SYSPAR Partition (2K) 
8K 40000(8) 
DSKPAR Partition 
36100(8) 
SECPAR Partition 
33200(8) 
0 0 


Figure 2-2 Baseline RKO5 Mapped System Partition Layout 


The minimum configuration supported by the mapped RSX-11M system is 
24K words. The partitioning scheme is such that all tasks except 
BIGMAC and BIGTKB run in partition GEN. BIGMAC and BIGTKB must run in 
partition PARI14K. 


2.1.2.4 MCR Source Disk Contents - The MCR source disk contains’ the 
following: 


UIC CONTENTS 
[1,1] System and Executive macro libraries 
[1,2] Error message text file, startup command file 
{1,20} Directory for unmapped MCR library files 
[1,24] Directory for mapped MCR library files 
[1,50] Baseline unmapped Executive and utility tasks 


[12,10] MCR source modules 


[12,20] Unmapped MCR assembly command files and library build 
file 


[12,24] Mapped MCR assembly command files and library build 
file 
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[12,30] Directory for unmapped MCR listing files 

[12,34] Directory for mapped MCR listing files 

[12,40] Directory for MCR correction files 

[45,10] K~series lab peripheral support source files 

[45,20] Assembly command files for K-series lab peripheral 
devices (unmapped) 

[45,24] Assembly command files for K-series lab peripheral 
devices (mapped) 

[200,200] SGNKLAB.CMD for generation of K-series lab support 


The RSX-11M system files distributed on this disk provide a 
number of utility tasks. 
the Executive source disk. 


limited 
The utility tasks are identical to those on 
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2.1.2.5 FCP and DMP Source Disk - The FCP and DMP source disk 
contains the following: 
UIC CONTENTS 
{1,1] System and Executive macro libraries 
{1,2] Error message text file, start up command file 
[1,20] Directory for unmapped FCP library file 
[1,24] Directory for mapped FCP library file 
[1,50] Baseline unmapped Executive and tasks required for 
SYSGEN 
[13,10] FCP source modules 
[13,20] Unmapped FCP assembly command file 
[13,24] Mapped FCP assembly command file 
{13,30] Directory for unmapped FCP listing files 
[13,34] Directory for mapped FCP listing files 
[13,40] Directory for FCP correction files 
[15,10] Source files for RMDEMO and the task shuffler 
[15,20] Directory for unmapped object modules 
[15,24] Directory for mapped object modules 
[15,30] Directory for unmapped listing files 
[15,34] Directory for mapped listing files 
[35,10] DMP source files 
[35,20] DMP assembly command file 
[35,30] Directory for DMP listing files 
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The RSX-11M system files distributed on this disk provide a limited 
number of utility tasks. The utility tasks are identical to those on 
the Executive source disk. 


2.1.2.6 Utility Object Disk Contents - The utility object disk 
contains the following: 


UIC CONTENTS 

[1,1] System object library, ANSI magtape FCS concatenated 
object module, and ODT 

[1,2] Error message file and Startup command file 

[1,20] ODL and build command files for unmapped utility tasks 

[1,24] Build command files for mapped utility tasks 

[1,30] UIC for unmapped map files 

[1,34] UIC for mapped map files 

[1,50] Baseline unmapped Executive and tasks required for 
SYSGEN 

[1,54] UIC for mapped task files 


[200,200] SYSGEN3.CMD and BLDUMD.CMD command files to build 
utility tasks and user mode diagnostic tasks. 


2.1.2.7 Device Combinations Supported by the Single RKO5 Distribution 
Kits - The following list contains the valid combinations of devices 
for use in generating a target system. You must have one of the 
following combinations to successfully complete a system generation 
with the single RKO5 kits: 

1. RKO5 disk and TA11 cassette (working storage) 

2. RKO5 disk and TU56 DECtape (working storage) 

3. RKO5 disk and RX01 floppy disk (working storage) 

4, RKO5 disk and TU10, TE10 or TSO03 magtape (working storage) 

5. RKO5 disk and TU16, TE16, or TU45 magtape (working storage) 


6. Two RKO5 disks (source and object disk simultaneously 
mounted) 


2.1.3 Dual RKO5 Release Kits - Summary 


2.1.3.1 Summary of Dual RKO5 Disk Release Kit Contents - The 
distribution kit contains five RKO5 disk cartridges identified as: 


1. Baseline System Disk - BASLINE 
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2. Executive Source Disk - EXECSRC 

3. User-tailored System Disk - SYSTEM 

4. Utility Object Disk - UTILOBJ 

5. MCR/FCP Source Disk - MCRFCP 
For a given system generation type, mapped or unmapped system, three 
of these disks are used: the Baseline system disk; the Executive 
source disk; and the User-tailored system disk. The Utility object 
disk is used if the non-privileged utility tasks are to be built. The 
MCR source disk is used if the user wishes to modify MCR or FCP. 
The dual RKO5 distribution kit requires 24K words of memory and either 
one RKO5 removable platter drive and one RKO5F fixed platter drive, or 
two RKO5 removable platter drives. 


The Baseline system disk (BASLINE), and the Executive source disk 
(EXECSRC), are used during the first phase of system generation. 


Among the files on the BASLINE disk are: 
1. The mapped and unmapped Baseline system Executive. 
2. The system tasks 


3. The system generation indirect command files PRESYSGEN.CMD, 
PRESGN1.CMD, PRESGN2.CMD, SGNXFER.CMD, and SGNXFER2.CMD. 


Among the files on the EXECSRC disk are: 
1. The system generation indirect command file, SYSGEN.CMD, the 
three query files SGNEXEC, SGNPER, and SGNTT, and 
SGNKLAB.CMD. 


Output files created during the first phase of system generation are 
generated on the EXECSRC disk and then copied to the BASLINE disk. 


2.1.3.2 Summary of Dual RKO5 Magtape Release Kit Contents - The 
release kit consists of five 600-foot, 9-track, 800 BPI magnetic 
tapes. The magtapes contain five RKO5 disk images. Also included, is 
a tape containing a stand-alone version of DSC. The five images 
correspond to the five disks described in Section 2.1.3.1. 
The five magtapes are: 

l. Baseline system tape containing the file BASLINE 

2. Executive source tape containing the file EXECSRC 

3. User-tailored system tape containing the file SYSTEM 

4. Utility object tape containing the file UTILOBJ 

5. MCR/FCP source tape containing the file MCRFCP 
Before beginning a SYSGEN, the appropriate files must be copied onto 


RKO5 cartridges using the Disk Save and Compress Utility (DSC). This 
procedure is described later in this Chapter. 


2.1.4 Dual RKO 


2.1.4.1 Baseli 
disk contains t 


UIC 


[1,1] 


[1,2] 

[1,50] 

[1,54] 
[200,200] 


The RSX-11M sys 
the utility tas 
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5 Release Kits - Details - 


ne System Disk (BASLINE) Contents - The Baseline system 
he following: 


Contents 


System libraries and the virtual memory workfile 
library 


Error message text and the startup command file 
Unmapped Baseline Executive and system tasks 
Mapped Baseline Executive and system tasks 


PRESYSGEN.CMD, PRESGN1.CMD, PRESGN2.CMD, SGNXFER.CMD, 
SGNXFER2.CMD, and COPYTSK.CMD 


tem that is distributed on this disk provides all of 
ks. 


The tasks contained on the BASLINE disk are: 


BAD 
BIGMAC - 
BIGTKB 
BOO = 
CDA = 
CMP = 
DMO = 
DMP = 
EDI = 
FCPNMH - 
FLX # 
IND = 
INI = 
INS = 
LBR = 
LOA = 
MAC = 
MCR = 
MOU = 
PAT = 
PIP = 
SAV = 
SLP = 
TKB = 
TKN = 
UFD = 
UNL = 
VFY = 
VMR = 
ZAP e 


Bad block locator routine 

14K Macro-ll assembler 

14K Task builder (RSX-11M Linker) 

MCR Boot command 

Crash dump analyzer 

Routine to compare ASCII source files 
MCR Dismount command 

File dump routine 

Line text editor 

2K non-multi-header file system 

File transfer routine 

Indirect command file processor 

MCR Disk Initialization command 

MCR Install command 

Library files maintenance and creation routine 
MCR Load command 

8K Macro-1ll assembler 

Monitor console routine 

MCR Mount command 

Object module patch routine 
Peripheral interchange program 

MCR Save command 

Source language input program 

8K task builder 

Task termination notification routine 
MCR User File Directory command 

MCR Unload command 

File structure verification routine 
Virtual monitor console routine 

Task image and data files patch routine 


Devices generated into this system are: 


4 RKO5 disk drives 


1 terminal 
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In addition, loadable drivers and data bases are provided for the 


following: 


MPH ENN 


TAl1 cassette drives 

TU56 DECtape drives 

RX01 floppy disk drives 
TE/TU1LO or TSO3 magtape drive 
TE/TU1L6 or TU45 magtape drive 
LP1ll or LS11 line printer 
PCll paper tape punch 


2.1.4.2 Executive Source Disk (EXECSRC) Contents - The Executive 
source disk contains the following: 


UIC 
[11,10] 
[45,10] 


[45,20] 


[45,24] 


[200,200] 


Contents 
The Executive source files 
K-series lab peripheral support sources 


Assembly command files for K-series lab peripherals on 
an unmapped system 


Assembly command files for K-series lab peripherals on 
a mapped system 


SGNEXEC.CMD, SGNTT.CMD, SGNPER.CMD, SYSGEN.CMD, 
SYSGENO.CMD, SGNKLAB.CMD 


2.1.4.3 Utility Object Disk (UTILOBJ) Contents - The utility object 
disk contains the following: 


UIC Contents 
[1,1] System libraries 
{1,2] Error message text and the startup command file 
[1,20] Object module libraries, task build command files for 
unmapped systems 
[1,24] Task build command files for mapped systems 
[200,200] SYSGEN3.CMD and BLDUMD.CMD 
2.1.4.4 User-tailored System Disk (SYSTEM) Contents - The 
User-tailored system disk contains the following: 
UIC Contents 
[1,1] System libraries, Executive symbol definition library, 
ODT and TRACE object modules, concatenated object 
module files for the Purdue ICS/ISA/UDC routines, 
virtual memory workfile library, and a concatenated 
object module file containing FCS routines for ANSI 
IMagtape support 
[1,2] Error message text and the startup command file 
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{1,20} Build command files for the system tasks on an unmapped 
system 

[1,24] Build command files for the system tasks on a mapped 
system 


[200,200] Assembly files for FCS ANSI mMagtape support, 
SYSGEN2.CMD, 11SGEN.CMD, BLDDRV.CMD, and SYSGEN2A.CMD 


2.1.4.5 MCRFCP Source Disk (MCRFCP) Contents - The MCR source disk 
contains the following: 


UIC Contents 

[1,1] The Executive macro library 

[1,20] The build command files for RMDEMO on an_ unmapped 
system 

[1,24] The build command files for RMDEMO and the shuffler 


(SHF) on a mapped system 
[12,10] Sources for MCR 
[12,20] MCR assembly command files for an unmapped system 
[12,24] MCR assembly command files for a mapped system 
[13,10] Sources for FCP 
[13,20] FCP assembly command file for an unmapped system 
[13,24] FCP assembly command file for a mapped system 


[15,10] Sources for RMDEMO and the task shuffler SHF 


2.1.4.6 Device Combinations Supported by Dual RKO5 - The following is 
a list of the valid device combinations for use in generating a target 
system. One of these combinations is required when using the dual 
RKO5 distribution kit. 


lL. An RKO5 removable platter disk drive and an RKOS5F fixed 
platter disk drive 


2. Two RKO5 removable platter disk drives 


2.1.5 RLO1 Kits - Summary 


2.1.5.1 Summary of RLO1 Disk Release Kit Contents - The distribution 
kit contains three RLO1 disk cartridges identified as: 


1. Mapped system object disk - MAPSYS 
2. Unmapped system object disk - UNMSYS 


3. Utility object disk - RLUTIL 
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For a given system generation type, mapped or unmapped system, one or 
two of these disks are used -- the applicable system object disk and, 
if any of the utilities are to be rebuilt, the utility object disk. 


The system object disks are used during the first two phases of 
SYSGEN. 


Among the files on these disks are: 
1. The Baseline System Executive and loadable drivers 
2. The System tasks 
3. Complete source code for the Executive 
4. The system generation indirect MCR command files SYSGEN.CMD, 


SYSGENO.CMD, SGNEXEC.CMD, SGNPER.CMD, SGNTT.CMD, SYSGEN2.CMD, 
1ISGEN.CMD, and BLDDRV.CMD 


2.1.5.2 Summary of RLO1 Magtape Release Kit Contents - The release 
kit consists of three 600-foot, 9-track, 800-BPI magtapes. The 
Magtapes contain three RLO1 disk images. Also included, iS a tape 
containing a stand-alone version of DSC. The three images correspond 
to the three disks described in Section 2.1.5.1. The three magtapes 
are: 


1. Mapped system object disk ~- MAPSYS 
2. Unmapped system object disk -— UNMSYS 
3. Utility object disk - RLUTIL 
Before beginning a SYSGEN, the appropriate files must be copied onto 


RLO1 cartridges using the Disk Save and Compress Utility (DSC). This 
procedure is described in Section 2.2.3.5. 


2.1.6 RLOl Release Kits - Details 


2.1.6.1 Mapped System Object Disk (MAPSYS) - The object disk for 
generating a mapped system contains the following: 


UIC Contents 

[1,1] Executive and system macro libraries, virtual memory 
workfile library, FORTRAN Purdue ICR/ICS/UDC routines 
object modules, ANSI magtape FCS concatenated object 
module, and ODT and TRACE debugging aids. 

[1,2] System error message file and the startup command file. 


[1,24] Mapped system tasks object module libraries and mapped 
system task-build command files. 


[1,54] Utility tasks 


[11,10] 
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All system-supplied tasks and loadable drivers built to 


run with this Executive. 


{200,200} The system generation indirect MCR command files 
SYSGEN.CMD, SYSGENO.CMD, SGNEXEC.CMD, SGNPER.CMD, 


SGNTT.CMD, SYSGEN2.CMD, and 11SGEN.CMD. 


The RSX-11M system that is distributed on this disk provides all 
the utility tasks. 


The tasks contained on the MAPSYS disk are: 


BAD 
BIGMAC 
BIGTKB 
BOO 


- Bad block locator routine 

~ 14K Macro-ll assembler 

~- 14K Task builder (RSX-11M Linker) 

- MCR Boot command 

- Crash dump analyzer 

- Routine to compare ASCII source files 
- MCR Dismount command 

- Line text editor 

- 2K non-multi-header file system 

- File transfer routine 

- Indirect command file processor 

~ MCR Disk Initializaiton command 

- MCR Install command 

- Library file, maintenance and creation routine 
- MCR Load command 

- 8K Macro-ll assembler 

- Monitor console routine 

- MCR Mount command 

- Object module patch routine 

- Peripheral interchange program 

- MCR Save command 

- Source language input program 

- 8K task builder 

- Task termination notification routine 
- MCR User File Directory command 

- MCR Unload command 

- File structure verification routine 

- Virtual monitor console routine 

- Task image and data files patch routine 


Devices generated into this system are: 


2 RLO1 disk drives 
1 terminal 


In addition, 


following: 


Meee rm h 


TA11 
TU56 
RXO01 
TU10 
TU16 
LP1l 
PCll 


loadable drivers and data bases are provided for 


cassette drives 
DECtape drives 

floppy disk drives 

or TSO3 magtape drive 
or TU45 magtape drive 
or LS1l1 line printer 
papter tape punch 


of 


the 
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2.1.6.2 Unmapped System Object Disk (UNMSYS) - The object disk for 
generating an unmapped system contains the following: 


UIC 


[1,1] 


[1,2] 


[1,20] 


[1,50] 
[11,10] 


[200,200] 


The RSX-11M sys 
the utility tas 


The tasks conta 


ZAP = 
Devices generat 


2 RLO1 dis 
1 Terminal 


Contents 


Executive and system macro libraries, virtual memory 
workfile library, FORTRAN Purdue ICR/ICS/UDC routines 
object modules, ANSI magtape FCS concatenated object 
module, and ODT and TRACE debugging aids. 


System error message file and the startup command file. 


Unmapped system tasks object module libraries and 
unmapped system task-build command files. 


Utility tasks 


All system-supplied tasks and loadable drivers built to 
run with this Executive. 


The system generation indirect MCR command files 
SYSGEN.CMD, SYSGENO.CMD, SGNEXEC.CMD, SGNPER.CMD, 
SGNTT.CMD, SYSGEN2.CMD,and 11SGEN.CMD. 


tem that is distributed on this disk provides all of 
ks. 


ined on the UNMSYS disk are: 


Bad block locator routine 

14K Macro-1ll assembler 

14K Task builder (RSX-11M Linker) 

MCR Boot command 

Crash dump analyzer 

Routine to compare ASCII source files 


MCR Dismount command 


File dump routine 

Line text editor 

2K non-multi-header file system 

File transfer routine 

Indirect command file processor 

MCR Disk Initialization command 

MCR Install command 

Library files maintenance and creation routine 
MCR Load command 

8K Macro-ll assembler 

Monitor console routine 

MCR Mount command 

Object module patch routine 
Peripheral interchange program 

MCR Save command 

Source language input program 

8K task builder 

Task termination notification routine 
MCR User File Directory command 

MCR Unload command 

File structure verification routine 
Virtual monitor console routine 

Task image and data files patch routine 


ed into this system are: 


k drives 
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In addition, loadable drivers and data bases are provided for the 
following: 


TA11 cassette drives 

TU56 DECtape drives 

RX01 floppy disk drives 
TU1O or TSO3 magtape drive 
TU16 or TU45 magtape drive 
LP1l or LS1ll line printer 
PCl1l paper tape punch 
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2.1.6.3 Utility Object Disk (RLUTIL) - The utility object disk 
contains the following: 


UIC Contents 
[1,1] Exeuctive and system macro libraries, virtual memory 


workfile library, ANSI magtape FCS concatenated object 
module, and ODT and TRACE debugging aids. 


[1,2] System error message file and the startup command file. 
[1,20] Task-build command files. 
[1,50] Baseline Executive and system tasks. 


[12,10] MCR source modules. 

[13,10] FCP source modules. 

[15,10] Source files for RMDEMO and the task shuffler. 
[35,10] DMP source files. 

[45,10] Source files for the K-series laboratory peripherals. 


[45,20] Build command files for K-series laboratory peripherals 
on an unmapped system. 


[45,24] Build command files for K-series laboratory peripherals 
on a mapped system. 


[200,200] System generation indirect MCR command files 
SYSGEN3.CMD and BLDUMD.CMD. 


2.1.7 RPO2/03, RPO04/05/06, RMO3 and RKO6 Magtape Release Kit 


The RP02/03, RP04/05/06, and RKO6 magtape release kits consist of four 
magtapes. Three tapes contain the saved image of the disk contents 
and the fourth tape contains a bootable, stand-alone version of the 
Disk Save and Compress utility (DSC) that copies the tape to disk. 
Each disk image contains a running unmapped and mapped Executive and 
all tasks. The unmapped Executive is bootstrapped automatically by 
the hardware bootstrap. In addition to the two systems, the disks 
contain all of the files necessary to build a target system as well as 
the source for the Executive, MCR, FCP, DMP, RMDEMO, and the’ shuffler 
task. You can generate a mapped or unmapped system while running 
either the unmapped or mapped Executive. The only difference between 
the kits is that each has the appropriate disk driver for the disk it 
is to run on... 
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2.1.7.1 RP02/03, RP04/05/06, RMO3, and RKO6 Magtape Release Kit 


Contents - The 


following: 
UIC 


[1,1] 


[1,2] 


[1,3] 
[1,4] 
[1,6] 


[1,20] 


[1,24] 


[1,30] 
[1,34] 


[1,50] 


[1,54] 


[1,60] 

[1,64] 

[11,10] 
[11,20] 
[11,24] 
[11,30] 
[11,34] 
[11,40] 
[12,10] 
[12,20] 


disk images in the magtape release kits contain the 


CONTENTS 
Executive and system macro libraries, the virtual 
memory workfile library, system object library, 
Executive symbol definition library, FORTRAN Purdue ISA 
routine object modules, ANSI magtape FCS concatenated 
object module, and ODT and TRACE debugging aids 


SYSGEN text file, system error message file, startup 
command file 


Directory for lost files found by VFY 

Directory for Snap Shot and Post-Mortem Dumps 

Directory for Error Log files 

Unmapped system privileged task object module 
libraries, nonprivileged task object module libraries, 
and unmapped system task-build command and overlay 
descriptor files 

Mapped system privileged task object module libraries, 
and mapped system task-build command and overlay 
descriptor files 

Directory for unmapped system task build maps 

Directory for mapped system task-build maps 

RSX-11M unmapped Baseline System Executive and all 
system-supplied tasks and loadable drivers built to run 
with this Executive 

RSX-11M mapped Baseline System Executive and all 
system-supplied tasks and loadable drivers built to run 
with this Executive 

Directory for unmapped RSX-11S Executive and tasks 
Directory for mapped RSX-11S Executive and tasks 
Executive source files 

Directory for unmapped Executive object files 

Directory for mapped Executive object files 

Directory for unmapped Executive listing files 
Directory for mapped Executive listing files 

Directory for Executive source correction files 


MCR source files 


Unmapped MCR assembly command files and object library 
build command file 
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[12,24] Mapped MCR assembly command files and object module 
library build command file 

[12,30] Directory for unmapped MCR listing files 

[12,34] Directory for mapped MCR listing files 

[12,40] Directory for MCR correction files 

[13,10] FCP source files 

[13,20] Unmapped FCP assembly command file 

[13,24] Mapped FCP assembly command file 

[13,30] Directory for unmapped FCP listing files 

[13,34] Directory for mapped FCP listing files 

[13,40] Directory for FCS correction files 

[15,10] Source files for RMDEMO system display task and_ the 
shuffler 

[15,20] Directory for unmapped RMDEMO and shuffler object files 

[15,24] Directory for mapped RMDEMO and shuffler object files 

[15,30] Directory for unmapped RMDEMO and shuffler listing 
files 

[15,34] Directory for mapped RMDEMO and shuffler listing files 

[35,10] DMP source files 

[35,20] DMP assembly command file 

[35,30] Directory for DMP listing files 

[45,10] K-series lab peripheral support source files 

[45,20] Assembly command files for K-series lab peripheral 
devices (unmapped) 

[45,24] Assembly command files for K-series lab peripheral 
devices (mapped) 

[200,200] SYSGEN command files, FCS and FORTRAN Object Time 
System (OTS) resident library files, and SGNKLAB.CMD 


file for generating K-series lab support 


The devices generated into the system for this kit are: 


2 RPO02/03, RP04/05/06 or RKO6 disk drives 
1 terminal 
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In addition, loadable drivers with loadable data bases are supplied 
for the following devices: 


TA11/TU60 cassette drives 

TC11/TU56 DECtape drives 

RX11/RX01 floppy disk drives 

TU10, TE10, or TSO3 magtape drive or 
TU16, TE16, or TU45 magtape drive 
LP1ll line printer 

PCll paper tape punch 


FH ke FR NN ND Nb 


The partition layouts for the unmapped and mapped systems are 
identical to those for the RKO5 distribution disks. Both the mapped 
and unmapped Executives are supplied with copies of all the system 
tasks. 


2.2 SAVING DISTRIBUTION DISKS 


2.2.1 Saving the Single and Dual RKO5 Distribution Disks 


Because the distribution disks are actively manipulated during the 
generation of a user-tailored system, you must back up the disks prior 
to their actual use in system generation. To allow preserving RKO5 
disks on cassette, DECtape or floppy disk, DIGITAL provides a 
stand-alone utility called the Volume Preservation Program (PRESRV). 
To save RKO5 disks on magtape or RKO5 disk, DIGITAL provides the 
utility DSC (disk save and compress) as a stand-alone system and also 
aS an object library to be built as a task. Both PRESRV and DSC are 
described in separate manuals. 


You must always save the object disk on which the system is to be 
generated, because the target system will replace the Baseline System 
on that disk. (It is also good practice to save the Executive source 
disk, as well as the MCR, FCP and DMP, and utility object disks.) 


Before saving the single RK0O5 release disks, you should verify that 
they can be read on your disk drives. You can do this by using the 
read-check option of the VFY program, which is available on all disks. 
After bootstrapping a disk, run VFY and specify the /RC (read-check) 
Switch. If any blocks are unreadable, VFY reports’ them. VFY is 
described in the RSX-1l Utilities Procedures Manual. If a disk is 
unreadable, call the local DIGITAL Software Support Specialist for 
assistance. 


A minimum RKO5 system must include one of the following sets of 
peripheral devices: 


1. An RKO5 disk and a dual TU56 DECtape unit, 

2. An RKO5 disk and a dual TA11 cassette tape unit, 
3. Dual RKO5 units, 

4. An RKO5 and an RX01 floppy disk, or 


5. An RKO5 disk and a TU1O, TU16, TU45, TE10, TE16, or “*TSO3 
magtape drive. 
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To save the disks in the distribution kit, follow the appropriate 
procedure described in Section 2.3 to bootstrap the unmapped object 
disk. Then, use the MCR BOOT command to bootstrap DSC or PRESRV. The 
full sequence is described below. 


Bootstrapping the system -- the following display results: 
RSX11M VO3.1 BL22 16K 

>RED DKO:=SY0: 

>RED DKO:=LB0: 

>MOU SY0O:UNMOBJ 

>@STARTUP 

*PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 

>TIM hrs:mins[:secs] [mnth/day/year ] 

>@<EOF> 

>INS [1,50]BOO 

Bootstrapping DSC using the following MCR command: 


>BOO [1,50]DSCSYS 


DSC is bootstrapped and the following display occurs: 


DSC>RSX-11S V02.1 BL22 DISK SAVE AND COMPRESS UTILITY 


Bootstrapping PRESRV using the following MCR commands: 


>BOO [1,50] PRESRV 


PRESRV is bootstrapped and the following display occurs: 

RSX-11S V02.1 BL22 

VOLUME PRESERVATION PROGRAM - V02.5 

FOR HELP TYPE /HE 

nn. ~ BLOCKS AVAILABLE FOR BUFFERING 
PRE> 
indicating that the PRESRV program is ready for input. The message 
nn. - BLOCKS AVAILABLE FOR BUFFERING indicates how many 256-word 
blocks are available for buffering. 
Depending on the specific backup medium you use (cassette, DECtape, 


RKO5 disk, or magtape), you should select one of the following 
procedures to back up the contents of the RKO5 disk. 


2.2.1.1 Preserving an RKO5 on DECtape: 

To backup an RKO5 on DECtape, use the following PRESRV command lines: 
PRE>DTO:label/BL:1/VE=DK0:/BL:1 (16K machines) 
PRE>DT0O:label/BL: 4/VE=DK0:/BL: 4 (all others) 


where label is the name to be given to the file on DECtape. 
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2.2.1.2 Preserving an RKO5 on Cassette: 


To back up an RKO5 on a cassette, use the following PRESRV command 
lines: 


PRE>CT0:label/BL:1/VE=DK0:/BL:1 (16K machines) 
PRE>CTO:label/BL: 3/VE=DK0:/BL: 3 (all others) 


where label is the name to be given to the file on the cassette. 


2.2.1.3 Saving an RKO5 on an RKOS: 
To back up an RKO5 on an RKO5, use the following DSC command line: 


DSC>DK1:/VE=DK0: 


2.2.1.4 Preserving an RKO5 on Floppy Disk: 


To back up an RKO5 on a floppy disk, use the following PRESRV command 
lines: 


PRE>DX0:label/BL: 1/VE=DK0:/BL:1 (16K machines) 
PRE>DX0:label/BL:6./VE=DK0/BL:12. (all others) 


where label is the name given to the file on the floppy disk. 


2.2.1.5 Saving an RKO5 on Magtape: 


To back up an RKO5 on a magnetic tape, use the following DSC command 
lines: 


DSC>MTO: /VEC=224 (TU1O, TE10, and TS03) 

DSC>MTO: /VE=DK0: 

DSC>MM0O: /VE=DKO0: (TUL6, TE16, and TU45) 
NOTE 


The following table shows the assignment 
of interrupt vectors in DSC to specific 
devices either by default, or by 
explicit use of the /VEC switch: 


Interrupt ‘ 


TU16/TE16/TU45 TU10/TE10/TSO3 


GETTING STARTED 


The first DECtape, cassette, or floppy disk that you use to preserve a 
volume contains a bootstrappable image of PRESRV; thus, if the system 
disk is inadvertently destroyed, you can restore it by bootstrapping 
from the first tape created. Such bootstrapping automatically 
initiates PRESRV, which you can then use to restore the original disk 
contents. 


You can put DSC onto a magtape or DECtape by using the VMR SAV command 
and thus make it available to single disk systems. 


For example, the following procedure copies DSC to a bootable magtape: 


>ASN XXn:=LB: 

>ASN XXn:=SY: 

>SET /UIC=[1,50] 

>LOA MT: 

>RUN SVMR 

ENTER FILE NAME:DSCSYS 
VMR>SAV MT:DSCSYS 
VMR>“Z 

> 


2.2.2 Saving the RP02/03, RP0O4/05/06, RKO5/06, RLOl, and RMO3 
Distribution Kits 
These distribution kits are on 600-foot, 9-track, 800-BPI magtapes and 
therefore, are already saved. To create a disk, you must copy the 
disk image file from tape to the disk by using DSC. The first step is 
to select the DSC tape, mount it on the drive, and boot in the 
Stand-alone version of DSC. The first tape is then mounted on tape 
drive zero. Following this, the disk is mounted on disk drive zero 
and allowed to reach operating speed. 
The command strings shown below copy the disk image from tape to disk. 
For RPO2 and RPO3 disks: 

DSC>DP: /VEC=254 (TULO, TE10, and TSO1) 

DSC>MT0: /VEC=224 

DSC>DP: /VE=MT0: 


DSC>DP: /VEC=254 (TUL6, TE16, and TU45) 
DSC>DP: /VE=MM0: 


For RP04/05/06 disks: 


DSCOMT: /VEC=224 (TU1LO, TE10, and TSO3) 
DSC>DB: /VE=MTO: 


DSC>DB: /VE=MMO0: (TUL6, TE16, and TU45) 
For RKO5 disks: 


DSC>MT0: /VEC=224 (TU1LO, TE10, and TSO1) 
DSC>DK0O:/VE=MTO0: 


DSC>DK0:/VE=MM0: (TUL6, TE16, and TU45) 
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For RKO6 disks: 


DSCOMT: /VEC=224 (TU1LO, TE10, and TS02) 
DSC>DM: /VE=MTO: 


DSC>DM: /VE=MMO : (TU16, TE16, and TU45) 
For RLO1 disks: 


DSCOMTO: /VEC=224 (TU1LO, TE10, and TSO1) 
DSC>DLO:/VE=MT0: 


DSC>DLO: /VE=MMO0: (TU16, TE16, and TU45) 
For RMO3 disks: 


DSCOMT: /VEC=224 
DSC>DR: /VEC=254 
DSC>DR: /VE=MTO: (TU1O, TE10, and TS03) 


DSC>DR: /VEC=254 
DSC>DR: /VE=MM0: (TU16, TE16, and TU45) 


2.2.3 Restoring Damaged Volumes 


If the system disk is destroyed on a single RKO5 system, it must be 
re-created by means of a backup that has been created by PRESRV or 
DSC. Bootstrapping a tape backup created via PRESRV produces’ the 
following console display: 


RSX-11S V02.1 BL22 

VOLUME PRESERVATION PROGRAM - V02.4 
FOR HELP TYPE /HE 

nn. —- BLOCKS AVAILABLE FOR BUFFERING 


PRE> 

PRESRV is now ready to accept commands. To restore the contents of a 
disk from cassette, DECtape or floppy disk, assuming the disk and 
backups are mounted on unit 0 of their respective controllers. You 


should then enter the appropriate commands given in sections 2.2.3.1 
through 2.2.3.5. 


2.2.3.1 Cassette Restoration 
PRE>DKO:/VE/BL:1/FO=CT0:label (16K machines) 
PRE>DKO: /VE/FO=CTO: label (all others) 
where label is the name that was specified when the disk was preserved 
on the cassette. Cassette bootstrapping without a cassette ROM 
bootstrap requires an extensive key-in procedure via the console 
switch register. 
On an 11/05/10/20/34/35/40/45/50/55/60/70, the key-in procedure is: 

1. Press HALT. 


2. Enter the address 001000 in the console switch register and 
press LOAD ADRS. 


Vs 
8. 


At this 
initial 
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PRE>DKO: 


PRE>DKO:/VE/FO=DT0: label/TP 
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Enter the first value from the right-hand column of the table 
below in the console switch register; lift the DEP switch. 


Enter the next value from the right-hand column of the table 
in the console switch register; lift the DEP switch. 

Repeat Step 4 for the remaining 26 values in the table. 

Enter the address 001000 in the console switch register and 


press LOAD ADRS. 

Lift the HALT switch. 

Press START. 

its 


point, the cassette is bootstrapped and PRESRV displays 


message and prompt. 


ADDRESS VALUE ADDRESS VALUE 


001000 012700 001034 100772 
001002 177500 001036 116012 
001004 005010 001040 000002 
001006 010701 001042 120337 
001010 062701 001044 000000 
001012 000052 001046 001767 
001014 012702 001050 000000 
001016 000375 001052 000755 
001020 112103 001054 005710 
001022 112110 001056 100774 
001024 100413 001060 005007 
001026 130310 001062 017640 
001030 001776 001064 002415 
001032 105202 001066 112024 


DECtape Restoration 
/VE/BL:1/FO=DT0:label/TP (16K machines) 


(all others) 


where label is the name that was specified when the disk was preserved 
to DECtape. 


2226363 


PRE>DKO:/VE/FO/BL: 1.=DX0:label/TP 


PRE>DKO:/VE/FO/BL: 12.=DX0:label/TP 


Floppy Disk-to-RK Disk Restoration 
(16K machines) 


(all others) 


where label is the name that was specified when the disk was preserved 
to floppy disk. 
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2.2.3.4 Restoring Damaged Disks with DSC - Mount the tape with the 
bootable image of DSC on unit zero of the appropriate controller and 
boot it with the bootstrap ROM. When DSC is loaded, it displays’ the 
following: 

RSX-11S V02.1 BL22 DISK SAVE AND COMPRESS UTILITY 

DSC> | 


It is now ready to accept commands. 


Disk to disk restoration: 


DSC>DK1: /VE=DK0: (RKO5) 
DSC>DM1:/VE=DM0: (RK06) 
DSC>DP: /VEC=254 (RP02/03) 


DSC>DP1:/VEC=254 
DSC>DP1:/VE=DP0: 


DSC>DB1:/VE=DB0: (RP04/05/06) 
DSC>DL1:/VE=DL0: 
DSC>DR: /VEC=254 
DSC>DR1: /VEC=254 
DSC>DR1:/VE=DRO: 


Magtape restoration: (TU10/TE10/TSO3) 


DSCOMT: /VEC=224 (setup vector for MT:) 
DSC>DKO:/VE=MTO: (RKO5) 
DSC>DM0O:/VE=MTO: (RK06) 

DSC>DP: /VEC=254 (RP02/03) 


DSC>DP0O:/VE=MT0: 
DSC>DB0O:/VE=MT0: (RP04/05/06) 


DSC>DRO: /VEC=254 
DSC>DRO: /VE=MTO: 


Magtape restoration: (TU16/TE16/TU45) 


DSC>DKO:/VE=MM0: (RK0O5) 

DSK>DM0O:/VE=MM0: (RKO6) 

DSC>DP: /VEC=254 (RP02/03) 

DSC>DP: /VE=MM0: 

DSC>DB: /VE=MM0: (RP04/05/06) 

It is advisable to create a backup disk. In the event that 


inadvertent destruction of a system disk occurs, a backup is available 
and you can create an additional backup at will. 


On systems with more than one disk unit, where disks are the normal 
backup medium, you can restore damaged system disks by copying the 
existing backup disk. 
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2.2.4 Exiting from PRESRV or DSC 


Because PRESRV and DSC are stand-alone programs, the only way to exit 
from them is to bootstrap in a new system or stand-alone program. 


2.2.5 Formatting Disks 


Formatted disks are required to restore or create a disk copy of the 
saved distribution kit disks. RKO5, RP02/03, and RP04/05/06 disks 
that have never been used, require formatting before any data can be 
written on them. RKO06 disks are pre-formatted at the factory and 
should not be formatted at the customer. site. Formatting a disk 
causes timing and addressing information to be recorded on the disk. 
This is done by using the stand~alone PRESRV_ program. The command 
lines given in Section 2.2.3 include the switch /FO, which indicates 
that a format pass should be made before copying the backup to. the 
disk. This ensures that all data is readable on the disk. For 
additional information see the PDP-ll Volume Preservation (PRESRV) 
User's Guide. You may also use the User Mode Diagnostics in an 
on-line system to format the disks. 


2.3 BOOTSTRAPPING THE BASELINE SYSTEM 


The procedure for bootstrapping depends on which hardware bootstrap is 
present on the host processor. On processors with a programmer 
console, the operator must first halt the processor by pressing the 
HALT key, set the console switches to the hardware bootstrap ROM 
address, press the LOAD ADRS key, and then press the START key. The 
RSX-11M system message is then displayed at the console terminal. The 
step-by-step procedure is carried out as described in section 2.3.1, 
223e25 “OL 233534 On an 11/04/34 processors having the M9301-YA/YB 
ROM, and those processors with the M9301-YF ROM the operator must 
press the BOOT button and enter (via the console terminal) the device 
name and unit number of the peripheral device from which the bootstrap 
is to occur. The step-by-step procedure is described in section 
2.3.4. 


2.3.1 Start-up Using the BM792-YB Bootstrap ROM 

1. Press HALT. 

2. Set the console switches to 173100. 

3. Press LOAD ADRS. 

4. Enter the address of the load device in the console switches: 
RK11 disk 177406 
RP11 disk 176716 
TCll DECtape 177344 

5. Lift up the HALT key. 

6. Press START. 


The start-up sequence shown in section 2.4 is then displayed on _ the 
console terminal. 


2.3.2 Start-up Using the MR11-DB Bootstrap ROM 


1. Press HALT. 
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2. Enter the address of the load device in the console switches: 


RK1l 
TC1I 
TM11 


RP1l 


disk 
DECtape 
magtape 


disk 


3. Press LOAD ADRS. 


173110 
173120 
173136 


173154 


4. Lift up the HALT key. 


5. Press START. 


The start-up sequence shown in section 2.4 is then 


console terminal. 


2.3.3 Start-up Using the BM873-YA Bootstrap ROM 


1. Press HALT. 


2. Enter the 
RK11l 
TCll 
TM11 
RP11 


RC11l 


displayed 


on 


the 


address of the load device in the console switches: 


disk 
DECtape 
magtape 
disk 


disk 


KL11/DL11 


TA11 cassette 


173010 
173030 
173050 
173100 
173144 
173210 


173230 


PCll papertape 173312 


3. Press LOAD ADRS. 


4. Lift up the HALT key. 


5. Press START. 


The start-up sequence shown in section 2.4 is then 


console terminal. 


displayed 


on 


the 
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2.3.4 Start-up Using the BM873-YB Bootstrap ROM 
l. Press HALT. 


2. Enter the address of the load device in the console switches: 


RK11 disk (unit 0) 173030 
RK11 disk (unit in switch register) 173032 
TCll DECtape (unit 0) 173070 
TM11/TMA11 magtape (unit 0) 173110 
RF1l disk 173136 
RH11/RH70/TMO2/TU16 magtape (unit 0) 173150 
RC1ll disk 173212 
RH11/RH70 device combination (unit 0) 173230 
RH11/RH70 device combination (unit in 173232 
Switch register) 
RH11/RH70/RP04 disk (unit 0) 173320 
RH11/RH70/RP04 disk (unit in 173322 
Switch register) 
RP11/RP02/RP03 disk (unit 0) 173350 
RP11/RP02/RP03 disk (unit in 173352 
switch register) 
KL11/DL11 console terminal reader 173510 
TAl1 cassette (unit 0) 173524 
TA11 cassette (unit in switch register) 173526 
PCll papertape reader 173620 
3. Press LOAD ADRS. (For units other than zero, enter unit 


number in switch register.) 
4. Lift up the HALT key. 
5. Press START. 


The start-up sequence shown in section 2.4 is then displayed on _ the 
console terminal. 
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2.3.5 Start-up Using the M9301-YA or M9301-YB Bootstrap ROM 
1. Press the BOOT switch. 


2. In response to the "$" prompt on the console terminal, enter 
one of the following: 


DB -— RJPO4 disk M9301-YB only 
DK - RKll disk 

DP - RP1l (RPO2/03) disk 

DT - TC1ll DECtape 

DX - RX1l floppy disk 

CT - TAl11 cassette tape 

MC - Mixed massbus device M9301-YB only 
MM - TMO2/TU16 magtape M9301-YB only 
MT - TM11/TU1O magtape 

PR —- PC11/PR11 paper tape reader 


TT 


KL11/DL11 console terminal reader 

followed by an optional, single octal digit for bootstrapping 
from units other than zero, and terminated by a carriage 
return. 


The start-up sequence shown in section 2.4 is then displayed on _ the 
console terminal. 


2.3.6 M9301-YC Bootstrap (PDP-11/70 Only) 


The M9301-YC bootstrap operates only on the PDP-11/70. Perform the 
following steps to use the bootstrap: 


1. Press HALT switch and set back to ENABLE position. 

2. Set the start of address of 17765000 in the console switches. 
3. Press LOAD ADDR. 

4. Set the device unit number in switches 0 through 2. 


5. Set the device code in switches 3 through 6. The device 
codes are: 


Code Device 

0001 TM11/TU10/TE10/TSO03 Magnetic Tape 
0010 TC11/TU56 DECtape 

0011 RK11/RK05 DECpack Disk Cartridge 


0100 RP11/RP02/RP03 Disk Pack 
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0110 RH70/TM02/TU16/TE16/TU45 Magnetic Tape 
0111 RH70/RP04/RP05/RP06 Disk Pack 
10 RH70/RS04/RS03 Fixed Head Disk 
6. Ensure that switches 7 through 21 are off (down). 
7. Press START. 


The system then displays on the console terminal the start-up sequence 
described in Section 2.4. 


Before the M9301-YC bootstrap actually boots the system, it performs 
CPU tests, instruction and addressing tests, and memory and cache 
tests. If a hardware failure is detected, the diagnostic program 
halts. The lights contain the ROM address of the halt. If this 
occurs, call your local DIGITAL Field Service Engineer. 


It may, however, be possible to continue with the bootstrap operation 
if the lights contain the address 17773644, 17773736, or 17773764, 
which indicates a cache failure. To continue in this case, press 
CONT. 


The M9301-YC bootstrap is capable of relocating its input to various 
banks of memory. However, RSX-11M can not be bootstrapped in this 
manner. 


2.3.7 M9301-YF Bootstrap ROM 


The following instructions bootstrap the system by means of the 
M9301-YF console emulator. Refer to the M9301 Bootstrap/Terminator 
Maintenance Manual, Order Number EK-M9301-MM, for other ways to boot 
the system with the M9301-YF. 


Follow this procedure at the operator's terminal: 
1. Press the console BOOT switch. 


If diagnostics are enabled,* the M9301-YF performs primary 
CPU diagnostics. The terminal then displays the contents of 
RO, R4, SP, and R5, respectively; the contents appear as 
four 16-bit octal numbers. Note that pressing the BOOT 
Switch at this time causes PDP-ll systems without console 
registers (PDP-11/04s, for example) to copy the PC into R5 
before the power-up sequence begins. 


The terminal then displays the prompt $ at the beginning of a 
new line. 


* The M9301-YF micro switches must be set to 000 to perform 
diagnostics when using the console emulator to boot the system. If 
_ the switches are set to 002, the M9301-YF console emulator boots’ the 
system without performing diagnostics. Consult a DIGITAL Field 
Service engineer or see the M9301 Bootstrap/Terminator Maintenance 
Manual. 
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2. In response to the prompt $, type the appropriate device code 
at the terminal, followed by carriage return: 


Code Device 
DBn RPO04, RPO5, RP06 
DKn RKO5 
DMn RK06 
DTn TU56 
DXn RX01 
MMn TU16, TU45, or TE16 
MTn TU1O or TE10 
PR PCll 
TT DL11 
In the list of codes above, n represents the device unit number; the 


only permissible values are 0 through 7. The unit number can be 
omitted if it is 0. 


If diagnostics are enabled, the M9301-YF performs secondary CPU and 
memory diagnostics before booting the system. The system then 
displays on the console terminal the start-up sequence described in 
section 2.4. 


2.4 CONSOLE DISPLAY 
If the system being bootstrapped contains support for devices which 
are not in the host configuration, a series of messages appears on the 
console terminal in the following form: 

DEVICE ddnn: NOT IN CONFIGURATION 


where: 


dd 
nn 


device name 
unit number 


Messages of this form indicate which devices are not physically 
present on the host system. These units are declared OFFLINE by the 
bootstrap code. 
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Then the system displays: 


RSX-11M V03.1 BL22 nnnnK [MAPPED] 
>RED ddnn:=SyY0: 
>RED ddnn:=LB0: 
>MOU ddnn:label 
>@[1,2] STARTUP 


where: 

v03.1 - The RSX-11M version number. 

BL22 - The RSX-11M base level number. 

nnnnK - Size of memory on hardware configuration 
from which the system was bootstrapped. 

MAPPED - MAPPED is displayed for systems built to 
use the memory management unit. 

dd - Load device name. 

nn ~ Load device unit. 

label - The volume label of the system disk. 

@[1,2]STARTUP - Start-up MCR command file that contains 
user determined commands to initialize the 
system. 


The system is now ready to run. The RED and MOU commands’ displayed 
are internally generated REDIRECT and MOUNT commands. The REDIRECT 
command establishes the load device as the system devices (LB: and 
SY:), and the MOUNT command mounts’ the load device as a Files-ll 
volume. The @[{1,2]STARTUP command is also internally generated and 
executes a set of MCR commands that initialize your system (e.g., to 
request that you set the time and date, etc.). 


CHAPTER 3 


SYSGEN DIALOGUE DETAILS 


3.1 SYSGEN DIALOGUE 


This chapter provides details of the SYSGEN dialogue. Each phase of 
the process is discussed. Section 3.2 covers phase 1 (SYSGEN.CMD and 
SYSGENO.CMD) ; Section 3.3, the query section (SGNEXEC, SGNPER, 
SGNTT); Section 3.4 covers phase 2 (SYSGEN2.CMD and BLDDRV.CMD); and 
Section 3.5, phase 3 (SYSGEN3.CMD and BLDUMD.CMD). 


All text, questions, and commands displayed during the running of the 
command file are described. However, during any single run of the 
command file, many of these questions and commands will not be 
executed, since they depend on both the machine configuration that the 
system generation is being run on, and the target machine the system 
is being built for. Appendix D contains a console output listing for 
an actual system generation run. 


At various places during the execution of the command files, SYSGEN 
asks questions to which the user must reply by typing Y (for yes), or 


N (for no), followed by a carriage return. (A reply of just a 
carriage return is an alternative way of saying no.) Such questions 
are distinguished by a leading asterisk (*) and trailing "? [Y/N]J:". 


Other questions require a string response. These have a leading 
asterisk and trailing "[S]:". There are also questions that require a 
numeric response. These have a leading asterisk and trailing "[O]:" 
for an octal response or "[D]:" for a decimal response. Usually, the 
numeric queries contain range and default arguments’ such as "[D 
R:1.-16. D:4.):." (Range arguments are the limits that the response 
must be within and the default argument is the value assigned if just 
carriage return is typed.) Command file processing is suspended until 
an answer is keyed in. 


In many places in the description of the command files, a command 
shown has a UIC specification containing one of the characters x and 
y- The command actually issued when the command file is processed 
will contain the character 0 or 4 as a replacement for x or y. The 
replacement for x depends on the target system (the system being 
generated) -- if the target system is unmapped, x is replaced by 0; 
if the target system is mapped, x is replaced by 4. Similarly, the 
replacement for y depends on the host system (the system that is 
currently running) -- if the host system is unmapped, y is replaced by 
0; if the host system is mapped, y is replaced by 4. 


Example: 
SET /UIC=[1,2x] 

will, during the processing of the command file, appear as 
SET /UIC=[1,24] 

if a mapped system is being generated. 
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The SYSGEN command files have been designed to inhibit the 
installation and removal of tasks already installed in the host 
system. This makes it possible to perform a SYSGEN on a multi-user 
system without affecting the tasks in that system. A SYSGEN can be 
performed on-line with a multi-user system by using the Assign (ASN) 
command to assign a logical device name (SY:) to a physical device 
containing a release disk. 


3.2 SYSGEN.CMD FILE DETAILS 


This section describes the entire SYSGEN.CMD indirect command file by 
adding descriptive text to the actual command file to clarify the 
SYSGEN process. The command file is presented in upper-case text; 
the descriptive text is presented in upper- and lower-case text. 


The SYSGEN.CMD indirect command file is common to all distribution 
kits. Hence, some sections pertain only to a specific kit or group of 
kits. Each section of the file that differs between kits is 
identified. To avoid confusion, read only these sections that pertain 
to your kit. 


If you are using the dual RKO5 distribution kit, you must initialize 
the system and supply parameters specific to the dual RKO5 kit. Also, 
it is required that you copy the distribution kit before beginning 
SYSGEN. The indirect command file PRESYSGEN.CMD supplies’ the 
necessary parameters and insures that you have copied the distribution 
kit. 


***DUAL RKO5*** 


The command file PRESYSGEN.CMD is used only when you are performing a 
SYSGEN with the dual RKO5 distribution kit. 


PRESYSGEN <VERSION 03.1> 
COPYRIGHT (C) 1977 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 
INITIALIZE SYSTEM FOR DUAL RKO5 SYSGEN 
THIS COMMAND FILE WILL PREPARE THE SYSTEM DISK FOR USE 
BY THE SYSTEM GENERATION PROGRAMS. 
THE DUAL RKO5 DISTRIBUTION KIT REQUIRES AT LEAST: 
24K WORDS OF MEMORY, AND 
ONE RKO5 REMOVABLE PLATTER DISK DRIVE, PLUS 
ONE RKO5F FIXED PLATTER DISK DRIVE 


OR 
TWO RKO5 REMOVABLE PLATTER DISK DRIVES. 


~e ~e ~O MO wR TS ONO UME UNO TE MOH TO UMS MO MO ME NO NE MO 


* 


DOES THIS SYSTEM MEET THE ABOVE REQUIREMENTS? [Y/N]: 


If it does not, you are informed to contact your local 
Digital office to obtain the correct distribution kit. 


If it does, PRESYSGEN continues. 


BEFORE STARTING SYSGEN, YOU MUST MAKE A COPY OF THE DISTRIBUTION 
KIT. THIS WILL ENSURE THAT YOUR DISTRIBUTION KIT IS COMPLETE AND 


me ™O 
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SERVE AS A BACKUP. AS THE BASLINE, EXECSRC, AND SYSTEM DISKS ARE 
ALTERED BY SYSGEN, IT IS NECESSARY TO USE A NEW COPY EACH TIME. 


me ™e 


* 


HAVE YOU COPIED THE DISTRIBUTION KIT AS REQUIRED? [Y/N]: 


If you have not made a copy, the following is displayed and 
PRESYSGEN halts. 


WE WILL EXIT NOW SO THAT YOU CAN COPY THE DISTRIBUTION KIT. 
AFTER THE COPYING IS COMPLETE, START THE PRESYSGEN FILE AGAIN. 


=e Oe 


If you have copied the kit, PRESYSGEN continues. 
* IN WHICH RKO5 UNIT IS THE BASLINE DISK MOUNTED? [0 R:0-3]: 


The following assumes that the BASLINE disk is mounted in 
DK1:. 


The RKO5 unit containing the BASLINE disk is assigned to the 
pseudo device SY:. 


ASN DK1:=SY: 
* ARE YOU RUNNING SYSGEN STANDALONE? [Y/N]: 
**STANDALONE SYSGEN** 
ASN DK1:=LB: 
* DOES THIS SYSTEM HAVE TWO RKO5 REMOVABLE PLATTER DRIVES? [Y/N]: 


If you have two removable RKO5 drives, the next question is 
bypassed. 


If you have a fixed platter drive, you must copy the BASLINE 
disk to it. 


* HAVE YOU COPIED THE BASLINE DISK TO THE RKO5SF? [Y/N]: 


If you have not, instructions for doing so are displayed and 
PRESYSGEN terminates. Otherwise, PRESYSGEN continues with 
the query to determine whether or not you are generating a 
mapped system. 


WE WILL USE ONE UNIT OF THE RKO5F FOR THE SYSTEM DISK. YOU WILL 
HAVE TO COPY THE SYSTEM DISK TO THE RKO5F, USING DSCSYS. BECAUSE 
DSCSYS SUPPORTS ONLY TWO LOGICAL DEVICE UNITS, USE THE /UNIT 
SWITCH AS SHOWN BELOW: 


me ~e ~O NO 


RSX-11S vV0O2.1 BL22 DISK SAVE AND COMPRESS UTILITY 


DSC>DKO: /UNIT=n 
DSC>DK1: /UNIT=m 
DSC>DK0O:=DK1: 
DSC> 


AFTER DSC HAS COMPLETED THE COPY, HARDWARE BOOT THE RKO5F AND 
START THE PRESYSGEN COMMAND FILE ON IT 


=e ™e we se ™O8 NO NO TO NO 


INS $BOO 
BOO [1,50]DSCSYS 


If you have two removable RKO05 drives or if you have copied 
the BASLINE disk to the RKO5F, PRESYSGEN continues here. 
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* ARE YOU GENERATING A MAPPED SYSTEM? [Y/N]: 
*STANDALONE AND MAPPED* 


SET /UIC=[1,54] 

INS S$PIP 

PIP [1,54] /RE/NV=[1,50] BADSYS.*;*,DSCSYS.*;*,PRESRV.*;* 
REM PIP 


WE WILL NOW BOOT THE MAPPED BASELINE SYSTEM. ONCE IT IS RUNNING, 
DISMOUNT THE SYSTEM DISK AND SAVE THE SYSTEM, WRITING A NEW BOOT 
BLOCK. WHEN THE SYSTEM COMES UP AGAIN, START THE PRESGN1 INDIRECT 
COMMAND FILE. E.G., 


RSX11M V03.1 BL22 64K MAPPED 

>RED DK1:=SyY0: 

>RED DK1:=LB0: 

>MOU DK1:BASLINE 

>@{1,2] STARTUP 

>*PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 1:00 1/1/78 
>TIM 1:00 1/1/78 

>@ <EOF> 

>DMO DKl1: 

>SAV /WB 


RSX11M V03.1 BL22 64K MAPPED 

>RED DK1:=SY0: 

>RED DK1:=LBO0: 

>MOU DK1:BASLINE 

>@[1,2] STARTUP 

*PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 1:02 1/1/78 
>TIM 1:02 1/1/78 

>@ <EOF> 

>@ PRESGN1 
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INS $BOO 
BOO [1,54]RSX11M 


The following is the display of PRESGNI. 
* HAVE YOU SAVED THE MAPPED SYSTEM? [Y/N]: 


If you have not, the following is displayed and PRESGN1 
halts. Otherwise, PRESGN1 continues. 


WE WILL EXIT NOW SO THAT YOU CAN DISMOUNT THE BASLINE DISK, 
SAVE AND WRITE A BOOT BLOCK FOR THE MAPPED SYSTEM AND THEN 
RESTART THE PRESGN1 COMMAND FILE. 


>DMO DK1: 
>SAV /WB 


=e “=e “se “~e TO NE 


If you have saved the mapped system, PRESGN1 continues here. 
INS $PIP 
SET /UIC=[1,54] 
PIP [1,50]*.*;*/DE 

The above commands delete the unmapped system. 


* ENTER THE UNIT NUMBER OF THE EMPTY RKO5 DRIVE [0 kR:0-3]: 


The following assumes DK2: is the empty drive. 
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; PLACE THE EXECSRC DISK IN DK2: AND START IT UP 
* IS THE EXECSRC DISK READY? [Y/N]: 
This query is repeated until the disk is ready (Y response). 
MOU DK2:EXECSRC 
ASN DK2:=SY: 
ASN DK1:=LB: 
SET /UIC=[1,1] 


PIP LB: /CO=RSXMAC.SML 
REM PIP 


Control is then passed to the indirect command file 
SYSGEN.CMD. 


*STANDALONE AND UNMAPPED* 
SET /UIC=[1,54] 
INS $PIP 
PIP *.*;*/DE 
The above commands delete the mapped system. 
* ENTER THE UNIT NUMBER OF THE EMPTY RKO5 DRIVE [O R:0-3]: 


The following assumes DK2: is the empty drive. 


PLACE THE EXECSRC DISK IN DK2: AND START IT UP (WRITE ENABLED) 


=e 


* IS THE EXECSRC DISK READY? [Y/N]: 
This query is repeated until the disk is ready (Y response). 


MOU DK2:EXECSRC 

ASN DK2:=SY: 

SET /UIC=[1,1] 

PIP LB: /CO=RSXMAC.SML 
REM PIP 


Control is then passed to the indirect command file 
SYSGEN.CMD. 


**ON-LINE SYSGEN** 


TO PERFORM A SYSGEN ON-LINE, THE FOLLOWING TASKS MUST BE 

INSTALLED: EDI, FLX, INI, MAC, PIP, TKB, AND UFD. THESE TASKS MUST 
REMAIN INSTALLED ON THE RUNNING SYSTEM UNTIL THE SYSGEN PROCESS IS 
COMPLETE. WE WILL PAUSE NOW TO ALLOW YOU TO INSTALL THE REQUIRED 
TASKS. 


=e =e “6 SS NO 


After you have installed the requisite tasks, type RES AT. 
to continue. The RKO5 unit that contains the BASLINE disk 
is then assigned to the pseudo device LB:. The following 
assumes that DKl: contains the BASLINE disk. 


ASN DK1:=LB: 

* DOES THE RUNNING SYSTEM HAVE TWO REMOVABLE RK05 DISK DRIVES? [Y/N]: 
If you have two removable RK05s, the following is displayed. 
If you have an RKO5F, the next three queries and associated 


text is omitted; the next query will concern the unit 
number of the RKOSF. 


SYSGEN DIALOGUE DETAILS 


* ARE YOU GENERATING A MAPPED SYSTEM? [Y/N]: 


If you are, the unmapped BAD, DSC, and PRESRV files are 
copied to the mapped directory and then the unmapped files 
are deleted. 


SET /UIC=[1,54] 
PIP [1,54] /RE/NV=[1,50] BADSYS.*;*,DSCSYS.*;*,PRESRV. *;* 
PIP [1,50]*.*;*/DE 


If you are not generating a mapped system, the files for a 
Mapped system are deleted. 


PIP [1,54]*.*;*/DE 


Whether you are generating a mapped or unmapped system, the 
following is displayed. 


* ENTER THE UNIT NUMBER OF THE EMPTY RKO5 DRIVE [O R:0-3]: 

The following assumes that DK2: is the empty drive. 
; PLACE THE EXECSRC DISK IN DK2: AND START IT UP (WRITE ENABLED). 
* IS THE EXECSRC DISK READY? [Y/N]: 


This question is repeated until the disk is ready (Y 
response). 


MOU DK2:EXECSRC 

ASN DK2:=SY: 

SET /UIC=[1,1] 

PIP LB:/CO=RSXMAC.SML 


Control then passes to the indirect command file SYSGEN.CMD. 
The following is displayed if you have an RKO5F drive. 
WE WILL USE ONE UNIT OF THE RKO5SF FOR THE BASLINE DISK. BECAUSE 


THE BASLINE DISK WILL NOT BE USED AS THE RUNNING SYSTEM, WE WILL 
CREATE THE UFD'S NECESSARY AND PIP THE FILES TO THE RKOSF. 


ée se WO 


* ENTER ONE UNIT NUMBER OF THE RKO5SF: 


The following assumes that DK1l: was entered. 


ALL DK1: 

INI DK1:BASLINE/BAD= [AUTO] 

MOU DK1:BASLINE 

ASN DK1:=SY: 

SET /UIC=[1,1]; 

PIP /UF/CO=LB:SYSLIB.OLB, VMLIB 

SET /UIC=[1,2] 

PIP /UF/CO=LB:QIOSYM.MSG,STARTUP.CMD 
UFD DK1: [1,20] 

UFD DK1: [1,24] 

UFD DK1: [1,50] 

UFD DK1: [1,54] 

UFD DK1: [2,20] 

UFD DK1: [200,200] 

SET /UIC=[200,200] 

_ PIP =LB:PRESGN2.CMD,SGNXFER,SGNXFER2,COPYTSK 
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* ARE YOU GENERATING A MAPPED SYSTEM? [Y/N]: 


The following assumes that you are generating a mapped 
system. Note that if you are generating an unmapped system 
the UIC is set to [1,50]. 


SET /UIC=[1,54] 
PIP =LB:[1,50]BADSYS.*,DSCSYS.*,PRESRV. * 
PIP @[200,200}]COPYTSK 


After the files are copied, the indirect command file 
PRESGN2.CMD is invoked to replace the BASLINE disk with the 


EXECSRC disk. The following actually comes from 
PRESGN2.CMD. 


; REMOVE THE BASLINE DISK FROM DK]: AND REPLACE IT WITH THE 
; EXECSRC DISK. 


* IS THE EXECSRC DISK READY? [Y/N]: 


This question is repeated until the disk is ready (Y 
response). 


MOU DK1:EXECSRC 

ASN DK1:=LB: 

SET /UIC=[1,1] 

PIP LB: /CO=RSXMAC.SML 


Control is then passed to the indirect command file 
SYSGEN.CMD. 


***ALL SYSTEMS*** 
The following begins the display of the indirect command 
file SYSGEN.CMD. 
SYSGEN PART 1 <VERSION 03.1> 


COPYRIGHT (C) 1975, 1976, 1977 
DIGITAL EQUIPMENT CORP., MAYNARD MASS. 01754. 


DETERMINE SYSTEM FEATURES AND ASSEMBLE THE EXECUTIVE 


=e we Ne Ne Ne Ne Ne NO NO 


SET /UIC=[200,200] 


EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP IN THIS 
SYSGEN COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


% se we NO TO Ne 


DO YOU WANT EXPANDED COMMENTS? [Y/N]: 


For the experienced programmer who has performed many 
SYSGENs, much of the descriptive text in the file may be 
Suppressed by answering N to this question. It is 
recommended that the less experienced or first time user 
answer Y, in order to be guided through the system 
generation process. 
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The next set of queries are asked to identify 


the 


distribution kit that is being used in SYSGEN. When a kit 


has been identified (a Y response to the query), 


further 


queries as to which distribution kit is being used are 
omitted and SYSGEN continues processing the applicable 


sections. 


* DO YOU HAVE THE SINGLE RKO5 DISTRIBUTION KIT? [Y/N]: 


If the response is affirmative, further queries to 


identify 


the kit are not necessary. The next queries are found under 


the heading SINGLE RKOS5 kit. 


If the response is negative, the following question 


asked. 


* DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 


If the response is affirmative, continue under’ the 
DUAL RKO5 KIT. 


If the response is negative, the following question 


asked. 


* DO YOU HAVE THE RLO1 DISTRIBUTION KIT? [Y/N]: 


This is the last query to identify the distribution kit. 
Y response obviously means that the kit is an RLO1 kit. 


next queries are found under the Heading RLO1 KIT. 


An N response implies that the distribution kit is 


disk type (RP02/03/04/05/06, RM03, or RKO6). 
queries are found under the heading ALL KITS. 


****x*SINGLE RKOS KIT***** 


This sections appears only if the response as to whether or 
single RKO5 kit is being used was affirmative. 


i a Sal Sl eT 


ese se Ne Ne NO 


AS A RESULT OF THE SYSGEN PROCEDURE, THE DISTRIBUTION KIT WILL 
BE CUSTOMIZED TO YOUR TARGET SYSTEM CONFIGURATION. YOU MUST MAKE 


A COPY OF IT BEFORE PROCEEDING ANY FURTHER IF YOU HAVEN'T 
ALREADY DONE SO. 


HAVE YOU ALREADY MADE A COPY OF THE EXEC SOURCE DISK? [Y/N]: 


is 


heading 


is 


A 
The 


big 


The next 


the 


As a result of SYSGEN, a number of files will be modified on 
the distribution kit. This might make the kit unusable for 


later SYSGENs. Therefore, the user must make a backup 


copy 


before performing a SYSGEN. If the answer to this question 


is N, SYSGEN part 1 terminates. 


DUE TO DISK SPACE RESTRICTIONS ON THE RKO5 DISTRIBUTION KIT 
(BOTH RK DISK AND MAGTAPE KITS) DRIVERS WHICH WILL NOT 
BE USED IN YOUR TARGET SYSTEM MUST BE DELETED. 


HAVE YOU ALREADY DELETED THE DRIVER SOURCE MODULES? [Y/N] :_ 


If the answer to this question is Y, the next section 


is 


bypassed. If the answer is N, the next section is entered 


to delete unused files. This text actually comes’ from 


command file SYSGENO.CMD. 


the 
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WE WILL NOW DELETE THE UNUSED DRIVER MODULES. THIS WILL MAKE 
ROOM FOR COMPLETING THE SYSGEN AND ALSO ROOM FOR CORRECTIONS 
TO THE EXECUTIVE WHICH ARE PUBLISHED IN THE SOFTWARE 
DISPATCH. IN GENERAL THIS WILL NOT CAUSE PROBLEMS 
SINCE RSX11M SUPPORTS A NUMBER OF PERIPHERAL DEVICES 
WHICH HAVE BEEN SUPERSEDED BY THOSE OF NEWER DESIGN. 
FOR EXAMPLE: 
IF YOU HAVE AN RP04/05/06 YOU PROBABLY DON'T HAVE AN RPRO02/03 
IF YOU HAVE AN RS03/RS04 YOU PROBABLY DON'T HAVE AN RF11 
IF YOU HAVE A TU16/45 YOU PROBABLY DON'T HAVE A TU10 
IF YOU HAVE A DMC11l YOU PROBABLY DON'T HAVE A DAI11-B 
AND SO ON. 


IF AT A LATER DATE, YOU ACQUIRE A DEVICE WHOSE DRIVER HAS BEEN 
DELETED FROM THIS DISK, YOU CAN EASILY RETRIEVE IT FROM THE 
ORIGINAL DISTRIBUTION DISK AND PUT IT ON THIS DISK. 


U) se se we we se we Se tO Ne we te we Ne Ne Ne Ne NO Ne 


ET /UIC=[11,10] 


In the following section, there is a question preceding each 
PIP command. The PIP command will actually be issued only 
if the answer to the preceding question is N. 


* DO YOU HAVE ANY ADO1-D A/D CONVERTER CONTROLLERS? [Y/N]: 
PIP ADDRV.MAC;*/DE 

* ANY AFC11 A/D CONVERTER CONTROLLERS? [Y/N]: 

PIP AFDRV.MAC;*/DE 

* ANY AR11 LABORATORY PERIPHERAL SYSTEM CONTROLLERS? [Y/N]: 
PIP ARDRV.MAC;*/DE 

* ANY CR11/CM11 CARD READER CONTROLLERS? [Y/N]: 
PIP CRDRV.MAC;*/DE 

* ANY TA11/TU60 CASSETTE DRIVES? [Y/N]: 

PIP CTDRV.MAC;*/DE 

* ANY RJP/RWP04/05/06 DISK DRIVES? [Y/N]: 

PIP DBDRV.MAC;*/DE 

* ANY RF1l1l FIXED HEAD DISK DRIVES? [Y/N]: 

PIP DFDRV.MAC;*/DE 

* ANY RK11/RK03/05 DISK DRIVES? [Y/N]: 

PIP DKDRV.MAC;*/DE 

* ANY RL11/RLO1 DISK DRIVES? [Y/N]: 

PIP DLDRV.MAC;*/DE 

* ANY RK611/RK06 DISK DRIVES? [Y/N]: 

PIP DMDRV.MAC;*/DE 

* ANY RP11/RPRO2/RP03 DISK DRIVES? [Y/N]: 

PIP DPDRV.MAC;*/DE 

* ANY RWMO3 DISK DRIVES? [Y/N]: 

PIP DRDRV.MAC;*/DE 

* ANY RJS/RWS03/04 FIXED HEAD DISK DRIVES? [Y/N]: 
PIP DSDRV.MAC;*/DE 

* ANY TC11/TU56 DECTAPE DRIVES? [Y/N]: 

PIP DTDRV.MAC;*/DE 

* ANY RX11/RX01 FLOPPY DISK DRIVES? [Y/N]: 

PIP DXDRV.MAC;*/DE 

* ANY VT11/VS60 GRAPHICS DISPLAYS? [Y/N]: 

PIP GRDRV.MAC;*/DE 

* ANY LPA11 LABORATORY PERIPHERAL ACCELERATORS? [Y/N]: 
PIP LADRV.MAC;*/DE 

* ANY LP11/LS11/LV11 PRINTERS? [Y/N]: 

PIP LPDRV.MAC;*/DE 

* ANY LPS11 LABORATORY PERIPHERAL SYSTEMS? [Y/N]: 
PIP LSDRV.MAC;*/DE 

* ANY TJ/TWU16/45/TE16 TAPE DRIVES? [Y/N]: 

PIP MMDRV.MAC;*/DE 
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* ANY TM11/TU10/TE10/TS03 TAPE DRIVES? [Y/N]: 
PIP MTDRV.MAC;*/DE 

* ANY PC1ll PAPER TAPE READER/PUNCHES? [Y/N]: 
PIP PPDRV.MAC;*/DE 

* ANY PR11 PAPER TAPE READERS? [Y/N]: 

PIP PRDRV.MAC;*/DE 

* ANY ICR/ICS11 INDUSTRIAL CONTROLLERS? [Y/N]: 
PIP ICDRV.MAC;*/DE,ICOM.MAC;* 

* ANY DRS/DSS11 DIGITAL INPUT/OUTPUT MODULES? [Y/N]: 
PIP ISDRV.MAC;*/DE, ISCOM.MAC;*,DSSDI.MAC;* 

* ANY UDC11 UNIVERSAL INDUSTRIAL CONTROLLERS? [Y/N]: 
PIP UDDRV.MAC;*/DE,UDCOM.MAC;* 

* ANY DA11-B UNIBUS LINKS? [Y/N]: 

PIP XBDRV.MAC;*/DE 

* ANY DL11-E ASYNCHRONOUS LINES? [Y/N]: 

PIP XLDRV.MAC;*/DE 

* ANY DMC11 INTERPROCESSOR LINKS? [Y/N]: 

PIP XMDRV.MAC;*/DE 

* ANY DP11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XPDRV.MAC;*/DE 

* ANY DQ11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XQDRV.MAC;*/DE 

* ANY DU11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XUDRV.MAC;*/DE 

* ANY DUP11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XWDRV.MAC;*/DE 


This is the end of SYSGENO.CMD. 


SET /UIC=[200,200] 
PIP SYSGENO.CMD;*/DE 


The next queries that will be displayed appear under’ the 
heading ALL KITS. 


***** DUAL RROD KiT***** 


This section appears only if the response as to whether or not the 
dual RKO5 kit is being used was affirmative and if SYSGEN is being 
initiated manually. The user is asked to identify the RKO5 units that 
contain the BASLINE disk and the EXECSRC disk. 


*IN WHICH RKO5 UNIT IS THE BASLINE DISK MOUNTED? 

*IN WHICH RKO5 UNIT IS THE EXECSRC DISK MOUNTED? 
The unit that contains the BASLINE disk is then assigned to 
LB:, and the unit that contains EXECSRC is assigned to SY:. 


ASN DKn:=SY: 
ASN DKn:=LB: 


DUE TO DISK SPACE RESTRICTIONS ON THE RKO5 DISTRIBUTION KIT 
(BOTH RK DISK AND MAGTAPE KITS) DRIVERS WHICH WILL NOT 
BE USED IN YOUR TARGET SYSTEM MUST BE DELETED. 


ese we NO Ne 


HAVE YOU ALREADY DELETED THE DRIVER SOURCE MODULES? [Y/N]: 


If the answer to this question is Y, the next section 
bypassed. If the answer is N, the next section is entered 
to delete unused files. This text actually comes from _ the 
command file SYSGENO.CMD. 


WE WILL NOW DELETE THE UNUSED DRIVER MODULES. THIS WILL MAKE 
ROOM FOR COMPLETING THE SYSGEN AND ALSO ROOM FOR CORRECTIONS 


=e =e 6™O 
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TO THE EXECUTIVE WHICH ARE PUBLISHED IN THE SOFTWARE 
DISPATCH. IN GENERAL THIS WILL NOT CAUSE PROBLEMS 
SINCE RSX11M SUPPORTS A NUMBER OF PERIPHERAL DEVICES 
WHICH HAVE BEEN SUPERSEDED BY THOSE OF NEWER DESIGN. 
FOR EXAMPLE: 
IF YOU HAVE AN RP04/05/06 YOU PROBABLY DON'T HAVE AN RPRO02/03 
IF YOU HAVE AN RS03/RS04 YOU PROBABLY DON'T HAVE AN RF1l 
IF YOU HAVE A TU16/45 YOU PROBABLY DON'T HAVE A TU10 
IF YOU HAVE A DMCl1 YOU PROBABLY DON'T HAVE A DA11-B 
AND SO ON. 


IF AT A LATER DATE, YOU ACQUIRE A DEVICE WHOSE DRIVER HAS BEEN 
DELETED FROM THIS DISK, YOU CAN EASILY RETRIEVE IT FROM THE 
ORIGINAL DISTRIBUTION DISK AND PUT IT ON THIS DISK. 


TU) se ~e ~e we Se we NO NO we Ne Ne Ne NO Ne Ne 


ET /UIC=[11,10] 


In the following section, there is a question preceding each 
PIP command. The PIP command will actually be issued only 
if the answer to the preceding question is N. 


* DO YOU HAVE ANY AD0O1-D A/D CONVERTER CONTROLLERS? [Y/N]: 
PIP ADDRV.MAC;*/DE 

* ANY AFC11 A/D CONVERTER CONTROLLERS? [Y/N]: 
PIP AFDRV.MAC;*/DE 

* ANY AR11 LABORATORY PERIPHERAL SYSTEM CONTROLLERS? [Y/N]: 
PIP ARDRV.MAC;*/DE 

* ANY CR11/CM11 CARD READER CONTROLLERS? [Y/N]: 
PIP CRDRV.MAC;*/DE 

* ANY TA11/TU60 CASSETTE DRIVES? [Y/N]: 

PIP CTDRV.MAC;*/DE 

* ANY RJP/RWP04/05/06 DISK DRIVES? [Y/N]: 

PIP DBDRV.MAC;*/DE 

* ANY RF11 FIXED HEAD DISK DRIVES? [Y/N]: 

PIP DFDRV.MAC;*/DE 

* ANY RK11/RK03/05 DISK DRIVES? [Y/N]: 

PIP DKDRV.MAC;*/DE 

* ANY RL11/RLO1 DISK DRIVES? [Y/N]: 

PIP DLDRV.MAC;*/DE 

* ANY RK611/RK06 DISK DRIVES? [Y/N]: 

PIP DMDRV.MAC;*/DE 

* ANY RP11/RPRO2/RP03 DISK DRIVES? [Y/N]: 

PIP DPDRV.MAC;*/DE 

* ANY RWMO3 DISK DRIVES? [Y/N]: 

PIP DRDRV.MAC;*/DE 

*ANY RJS/RWS03/04 FIXED HEAD DISK DRIVES? [Y/N]: 
PIP DSDRV.MAC;*/DE 

* ANY TC11/TU56 DECTAPE DRIVES? [Y/N]: 

PIP DTDRV.MAC;*/DE 

* ANY RX11/RX01 FLOPPY DISK DRIVES? [Y/N]: 

PIP DXDRV.MAC;*/DE 

* ANY VT11/VS60 GRAPHICS DISPLAYS? [Y/N]: 

PIP GRDRV.MAC;*/DE 

* ANY LPA11 LABORATORY PERIPHERAL ACCELERATORS? [Y/N]: 
PIP LADRV.MAC;*/DE 

* ANY LP11/LS11/LV11 PRINTERS? [Y/N]: 

PIP LPDRV.MAC;*/DE 

* ANY LPS11 LABORATORY PERIPHERAL SYSTEMS? [Y/N]: 
PIP LSDRV.MAC;*/DE 

* ANY TJ/TWU16/45/TE16 TAPE DRIVES? [Y/N]: 

PIP MMDRV.MAC;*/DE 

* ANY TM11/TU10/TE10/TSO3 TAPE DRIVES? [Y/N]: 
PIP MTDRV.MAC;*/DE 

* ANY PC1ll PAPER TAPE READER/PUNCHES? [Y/N]: 
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PIP PPDRV.MAC;*/DE 

* ANY PR11 PAPER TAPE READERS? [Y/N]: 

PIP PRDRV.MAC;*/DE 

* ANY ICR/ICS11 INDUSTRIAL CONTROLLERS? [Y/N]: 
PIP ICDRV.MAC;*/DE,ICOM.MAC;* 

* ANY DRS/DSS11 DIGITAL INPUT/OUTPUT MODULES? [Y/N]: 
PIP ISDRV.MAC;*/DE,ISCOM.MAC;*,DSSDI.MAC;* 

* ANY UDC11 UNIVERSAL INDUSTRIAL CONTROLLERS? [Y/N] 
PIP UDDRV.MAC;*/DE,UDCOM.MAC;* 

* ANY DA11-B UNIBUS LINKS? [Y/N]: 

PIP XBDRV.MAC;*/DE 

* ANY DL11-E ASYNCHRONOUS LINES? [Y/N]: 

PIP XLDRV.MAC;*/DE 

* ANY DMC11 INTERPROCESSOR LINKS? [Y/N]: 

PIP XMDRV.MAC;*/DE 

* ANY DP11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XPDRV.MAC;*/DE 

* ANY DQ11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XQDRV.MAC;*/DE 

* ANY DU11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XUDRV.MAC;*/DE 

* ANY DUP11 SYNCHRONOUS LINE INTERFACES? [Y/N]: 
PIP XWDRV.MAC;*/DE 


This is the end of SYSGENO.CMD. 


SET /UIC=[200,200] 
PIP SYSGENO.CMD;*/DE 


The next queries that will be displayed appear under the 
heading ALL KITS. 


K*EKEREO] KIT**R** 

This section appears only if the response as to whether or not the 
RLO1 kit is being used was affirmative. If you are using the RLO1 
kit, you must make a copy of it before proceeding with SYSGEN. 


YOU MUST MAKE A COPY OF THE RLO1 DISTRIBUTION KIT, IF YOU 
HAVE NOT DONE SO ALREADY. 


ue “Oe 


* HAVE YOU COPIED THE RLO1 DISTRIBUTION KIT? [Y/N]: 


If you have not copied the kit, the following is displayed 
and the command file exits. You must then restart SYSGEN. 


WE WILL EXIT NOW SO THAT YOU CAN COPY THE DISTRIBUTION KIT. 
AFTER YOU HAVE COPIED THE KIT RESTART THE SYSGEN COMMAND FILE. 


=e OE 


If you have copied the kit, the next queries appear under 
the heading ALL KITS. 


kKkKEKKaT] kitg*ee*** 
* ARE YOU BUILDING AN RSX11S SYSTEM? [Y/N]: 


The selection of features and assembly of the Executive are 
controlled by the SYSGEN.CMD command file. This question is 
used later to select the correct SYSGEN phase 2 command file 
for RSX-11M or RSX-11S and to determine the Executive 
options. 
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BUILDING A MAPPED SYSTEM? [Y/N]: 


The reply to this question determines the UIC settings that 
will be generated during the SYSGEN process. See Appendix A 
for UIC conventions used on the distribution kit disks. 


RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N]: 


The Baseline System Executive is set up with a 14K partition 
that can be used if the host machine has at least 24K of 
memory. If this is the case, SYSGEN will use the larger and 
faster version of MACRO-11 and the task builder during the 
generation process. 


RUNNING ON A MACHINE WITH A LINE PRINTER? [Y/N]: 


If you are, the next question is asked. Otherwise it is 
omitted. 


132. COLUMN LINE PRINTER? [Y/N]: 


WILL YOUR SYSTEM INCLUDE DSS-11 SUPPORT? [Y/N]: 
WILL YOUR SYSTEM INCLUDE ICS/ICR-11 SUPPORT? [Y/N]: 


When building DSS-ll and/or ICS/ICR-11 support into’ the 
Executive, device common blocks that map to the DSS-1l 
and/or ICS/ICR-1l device registers must be copied from the 
source disk to the disk on which SYSGEN phase 2 will be run. 
The reply to this question will cause the proper files to be 
copied at the right time. 


WILL YOUR SYSTEM INCLUDE UDC-11 SUPPORT? [Y/N]: 


When building UDC1l Support into the Executive, device 
common blocks that map to the UDCl1 device registers must be 
copied from the source disk to the disk on which SYSGEN 
phase 2 will be run. The reply to this question will cause 
the proper files to be copied at the right time. This 
question will not be asked if ICS/ICR-1l1 support was 
selected, since ICS/ICR-1l support precludes UDC1l support. 
The following section is pertinent if you are uSing an RKO6, 
RLO1, or RP distribution kit. It is also necessary on _ the 
RKO5 kits (single or dual) if the driver sources have 
already been deleted. 


DELETE FILES FROM PAST SYSGENS 


NOTE: ON VIRGIN DISKS, NONE OF THE FILES WE TRY TO 
DELETE WILL EXIST. PIP WILL GIVE ERROR MESSAGES 
THAT SHOULD INDICATE THAT THE FILE DOES NOT EXIST. 


In generating a system, several files are created. These 
files are of no use after a successful completion of a 
SYSGEN. If another SYSGEN is to be performed from a disk on 
which a previous SYSGEN was performed, these files should be 
deleted to free disk space. The following commands 
accomplish the desired cleanup. 


By convention, the following files in an unmapped system are 
stored under UIC [11,20]: 
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1. The assembly command file to assemble the Executive 
(RSXASM.CMD) 


2. The build command file to build the Executive 
(RSXBLD,.CMD) 


3. Executive object modules created during the assembly of 
the Executive 


4. A file of concatenated Executive object modules built by 
PIP and used by the Librarian to build the Executive 
object module library 


5. Files for the DSS-1l and/or ICS/ICR-11 or UDC11 used to 
build device common blocks for tasks which reference the 
device 


PIP [11,20] *.O0BJ;*/DE,*.UDC;*,*.ICR;*,*.IDS;* 
The preceding PIP commands delete: 
1. All object module files 
2. All versions of UDC1l1 modules 
3. All versions of ICS/ICR-1l1 modules 
4. All versions of DSS-11 modules 


On a release kit disk that has never had a SYSGEN 
performed on it, no residual files from a previous 
SYSGEN exist. Thus, the attempted deletion is 
flagged by PIP. 


These are warning diagnostics and do not affect the 
SYSGEN currently in progress. 


PIP [11,24] *.OBJ;*/DE,*.UDC;*,*.ICR;*,*.IDS;* 


It cannot be known whether the previous SYSGEN done on the 
source disk was for a mapped or an unmapped system. The 
preceding command deletes the files generated for building a 
Mapped system. 


PIP [11,30] UDCOM.LST;*/DE,ICTAB;*,ICOM;*,DSSDI;*,ISCOM;* 
PIP [11,34] UDCOM.LST;*/DE, ICTAB;*,ICOM;*,DSSDI;*,ISCOM;* 


The previous commands delete listing files generated for 
DSS-1ll, ICR/ICS-1ll, or UDC11 common blocks for both mapped 
and unmapped areas on the disk. 


By convention, UIC [11,10] is used for the device table file 
(SYSTB.MAC), prefix file (RSXMC.MAC), and the ICR/ICS-1l 
table file produced during the running of the three query 
files. The output of the query files is used to configure 
the system. 


PIP [11,10] RSXMC.MAC;*/DE,SYSTB;*,ICTAB;*,RSXBLD.TMP;* 


Delete all existing versions of the device table file, 
prefix file, and ICS/ICR-11l table. 
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PIP [11,20] RSXASM.CMD;*/DE,RSXBLD; * 
PIP [11,24] RSXASM.CMD;*/DE,RSXBLD;* 


Delete all existing versions of the assembly command file 
and task-build command file for the executive. 


Regardless of the distribution kit you are using and whether 
or not the driver sources’ have been deleted, processing 
continues here. 


SET /UIC=[11,10] 


333 SYSGEN QUERY SECTION 


; NOW WE BEGIN THE SYSGEN QUERY SECTION TO SELECT THE EXECUTIVE 
; FEATURES AND PERIPHERAL DEVICES WE WANT IN THE NEW SYSTEM 


Control is then passed to the SYSGEN query section beginning 
with the indirect command file SGNEXEC.CMD. 


The SYSGEN query section is run to produce the five files 
mentioned previously. This process consists of a number of 
interactive questions. The answers you supply to these 
queries provide SYSGEN with the information necessary to 
construct its output files. These files are then used by 
MACRO-11 and the Task Builder to create the user-tailored 
system. 


The question pertaining to production of the Executive map 
should be answered Y, since it is required in phase 2 of 
SYSGEN to determine partition layout. 


The Baseline System does not contain a print spooler; 
therefore, spooling of the listings or map should not be 
specified. 


The SYSGEN query section presents queries which, when 
answered, define Executive options, Processor options, and 
the Peripheral set for the user-tailored system. 


The query section consists of a series of questions which the user 
answers. At the completion of the query section, the user has 
specified all of the following: 


1. Executive options 
2. Processor options 
3. Peripheral set 


This section contains every question (listed in order of appearance) 
in the dialogue conducted by the query section. The dialogue itself 
has two options, long and short. Short dialogue consists only of the 
queries. Long dialogue precedes each query with explanatory text. 


In the text which follows, upper case is produced by the query section 
dialogue. Any additional explanation required appears in lower case 
and is indented for easy recognition. 


EXPANDED COMMENTS RESULT IN THE DISPLAY OF EXPLANATORY TEXT 
PRECEDING EACH QUERY. SHORT DIALOGUE OMITS THE TEXT. EXPANDED 
COMMENTS ARE AVAILABLE ON A PER QUERY BASIS BY ENTERING ESCAPE 
OR ALTMODE FOLLOWING THE DISPLAY OF THE QUERY. 
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LONG DIALOGUE DESIRED FOR EXECUTIVE/PROCESSOR OPTIONS? [Y/N]: 
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Once long dialogue is chosen, the explanatory text is 
displayed prior to each Executive/processor query and cannot 
be suppressed (except on a per query basis with CTRL/O). 
Selective short dialogue produces explanatory text following 
the query only when that query has been answered using 
ALTMODE/ESCAPE. 


SYSGEN PRODUCES INDIRECT FILES WHICH ARE SUBSEQUENTLY USED TO 
ASSEMBLE THE USER-TAILORED EXECUTIVE. LISTING PRODUCTION IS 
TIME CONSUMING AND IS NOT RECOMMENDED, ESPECIALLY IF THE 8K 
ASSEMBLER IS BEING USED (WHICH IS REQUIRED ON A 16K SYSTEM). 


ASSEMBLY LISTING FILES DESIRED? [Y/N]: 


FOR THE SINGLE RK0O5, DUAL RKO5 OR RLO1 DISTRIBUTION KITS, RUNNING 
STANDALONE, YOU MAY DIRECT THE EXECUTIVE LISTINGS TO THE LINE 
PRINTER, OR ANOTHER DISK OF THE SAME TYPE AS YOUR KIT. NOTE THAT 
THE LISTINGS WILL NOT FIT ON THE DISTRIBUTION DISKS FOR THE ABOVE. 


FOR OTHER DISTRIBUTION KITS, YOU MAY SPECIFY A LINE PRINTER, THE 
THE DISTRIBUTION KIT DISK (SY0Q) OR A SECOND DISK OF THE SAME TYPE. 


FOR ALL ONLINE SYSGENS, YOU MAY SPECIFY ANY DISK WITH A LEAST 
4000 FREE BLOCKS. NOTE THAT SYSGEN WILL NOT LOAD THE DRIVER FOR 
THIS DISK. 


The next two queries do not appear unless assembly listings 
were requested. 


WHAT IS TO BE THE LISTING DEVICE? [DDU]: 


The listing files need not be directed to a line printer. 
They can be directed to a terminal or a disk, e.g., TTO: or 
DKl:, subject to the above restrictions. 


SPOOLING WILL ONLY ACTUALLY OCCUR FOR DIRECTORY DEVICES. 
NOTE THAT THE BASELINE SYSTEM DOES NOT INCLUDE A PRINT SPOOLER. 


SPOOL LISTING FILES? [Y/N]: 


The Baseline System does not have a print spooler. 
Therefore, if the SYSGEN is being performed on the Baseline 
System, the user should select no spooling of either listing 
files or map files. 


A TASK BUILDER MAP IS STRONGLY RECOMMENDED. ESTABLISHING 
PARTITIONS AND DIAGNOSING SYSTEM FAILURES REQUIRE THIS MAP. 
FOR ALL DISTRIBUTION KITS. IT IS RECOMMENDED 

THAT YOU SPECIFY SYO FOR THE MAP 

DEVICE. 


TASK BUILDER MAP DESIRED? [Y/N]: 


The only way to lay out partitions for a target system is to 
have the value of the last address used by the Executive. 
This value can be obtained only from the Executive memory 
allocation map. The next two queries do not appear unless a 
map was requested. 


WHAT IS TO BE THE MAP DEVICE? [DDU]: 
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SPOOL MAP FILE? [Y/N]: 


SPOOLING WILL ONLY ACTUALLY OCCUR FOR DIRECTORY DEVICES. 
NOTE THAT THE BASELINE SYSTEM DOES NOT INCLUDE A PRINT SPOOLER. 


THE PRECEDING QUERIES DO NOT AFFECT THE USER-TAILORED 
EXECUTIVE. THE EXECUTIVE OPTION QUERIES THAT FOLLOW WHICH ARE 
PRECEDED BY A SINGLE ASTERISK ARE INCLUDED IN THE BASELINE 
SYSTEM. THE FEATURE, HOWEVER, IS NOT ESSENTIAL TO THE 
OPERATION OF A MINIMUM SYSTEM. DOUBLE ASTERISKED QUERIES MUST 
BE SELECTED FOR FULL SUPPORT OF THE MINIMUM SYSTEM. QUERIES 
WITH NO ASTERISKS ARE NOT IN THE MINIMUM SYSTEM AND ARE 
OPTIONAL. 


The indication of minimum system features applies only to 
RSX-11M systems. 


BEGIN EXECUTIVE SERVICE OPTIONS. 


AS DISTRIBUTED, THE RSX-11M SOURCE DISK PROVIDES FOR THE 
GENERATION OF AN RSX-11S EXECUTIVE. IN ORDER TO GENERATE SUCH 
A SYSTEM YOU MUST HAVE AN RSX-11S LICENSE AND CANNOT INCLUDE 
FILES-l11, CHECKPOINTING, NONRESIDENT TASK, OR DYNAMIC MEMORY 
ALLOCATION SUPPORT. 


ARE YOU BUILDING AN RSX-11S SYSTEM? [Y/N]: 


The following question concerning terminal driver support 
appears only if an RSX-11S system is being generated. 


DO YOU WANT TERMINAL DRIVER SUPPORT? [Y/N]: 


If an RSX-11S system is being generated, then the next four 
queries do not appear. 


FAILURE TO INCLUDE THIS OPTION ELIMINATES ALL THE SERVICES 
DESCRIBED IN THE RSX-11 I/O OPERATIONS REFERENCE MANUAL. SINCE 
DEC SUPPLIED SOFTWARE MAKES USE OF THESE SERVICES, THEIR 
ELIMINATION IS NOT RECOMMENDED. 


**DO YOU WANT FILES~11 ACP SUPPORT? [Y/N]: 
THIS OPTION IS REQUIRED IF YOU WANT SUPPORT FOR RMS-1l. 
DO YOU WANT RMS RECORD LOCKING AND PLACEMENT CONTROL SUPPORT? [Y/N]: 


IF TASKS ARE TO BE DISPLACED FROM A PARTITION TO YIELD THE 
PROCESSOR RESOURCES TO A TASK OF HIGHER PRIORITY ABLE TO USE 
THE PARTITION, THEN CHECKPOINTING IS REQUIRED. 


**DO YOU WANT CHECKPOINTING? [Y/N]: 


For large systems, checkpointing may not be required if MCR, 
TKN, and FCP each operate in a dedicated partition; thus, 
checkpointing may be omitted (checkpointing is, however, 
strongly recommended) . Note that, in a minimum system, 
these tasks must run in the same partition and, therefore, 
checkpointing is required. 


If checkpointing is selected, then the following question is 
asked, and the nonresident task query does not appear. 
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SELECTION OF THIS OPTION ALLOWS CHECKPOINTING INTO A SYSTEM 
CHECKPOINT FILE RATHER THAN REQUIRING SPACE IN EACH TASK. 


If selected, system checkpoint files are allocated by an MCR 
command. The first checkpoint file allocated becomes the 
primary file and so forth. 


DO YOU WANT DYNAMIC CHECKPOINT ALLOCATION? [Y/N]: 


IF SELECTED, THE SYSTEM WILL CONTAIN A TASK LOADER. NOT 
INCLUDING THIS LOADER MEANS TASKS MUST BE PERMANENTLY RESIDENT 
IN THE GENERATED SYSTEM. 


**DO YOU WNAT NON-RESIDENT TASK SUPPORT? [Y/N]: 


REQUIRED IF THE USER-TAILORED SYSTEM HAS A 
MEMORY MANAGEMENT UNIT FOR WHICH RSX-11M/S SUPPORT IS DESIRED. 


ARE YOU BUILDING A MAPPED SYSTEM? [Y/N]: 


If you are not building a mapped system, the next five 
questions are omitted. 


For unmapped systems, the next questions displayed begin 
with address checking. 


*MAPPED* 


THIS OPTION ALLOWS AS MANY TASKS AS WILL FIT IN A PARTITION TO 
BE SIMULTANEOUSLY RESIDENT. THE ALLOCATION OF PARTITION MEMORY 
IS AUTOMATIC AND IS CARRIED OUT DYNAMICALLY BY THE RSX-11M 
EXECUTIVE. 


DO YOU WANT DYNAMIC MEMORY ALLOCATION SUPPORT? [Y/N]: 


If dynamic memory allocation is selected, the next question 
is also asked. 


AUTOMATIC MEMORY COMPACTION MINIMIZES THE EFFECTS OF 
FRAGMENTATION IN DYNAMICALLY ALLOCATED PARTITIONS. IT IS 
INVOKED WHEN FREE SPACE EXISTS BETWEEN RESIDENT 
NONCHECKPOINTABLE TASKS AND TASKS ARE WAITING TO BE LOADED 
INTO THE PARTITION. 


DO YOU WANT AUTOMATIC MEMORY COMPACTION? [Y/N]: 


Memory compaction is implemented as a nonresident’ task 
called the Shuffler. Whenever it is necessary to compact 
memory in a partition, the Shuffler is automatically loaded 
and proceeds to checkpoint tasks and move them toward the 
front of the partition in an attempt to provide better 
memory utilization. 


THE MEMORY MANAGEMENT DIRECTIVES PROVIDE TASKS WITH A PROTECTED 
MECHANISM BY WHICH THEY CAN DYNAMICALLY CREATE AND DELETE 
COMMON BLOCKS AND DYNAMICALLY MODIFY THEIR PHYSICAL ADDRESS 
SPACE MAPPING. 


DO YOU WANT THE MEMORY MANAGEMENT DIRECTIVES? [Y/N]: 
The memory management directives are available only on a 


mapped system. If selected, the next two questions are 
asked. 
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THESE DIRECTIVES ALLOW ONE TASK TO SEND TO ANOTHER TASK A 
REFERENCE TO AN AREA WITHIN A PARTITION. THE RECEIVER TASK IS 
GIVEN A SPECIFIED ACCESS ALLOWING IT TO SUBSEQUENTLY MAP TO OR 
DELETE THE PARTITION. 


DO YOU WANT THE SEND/RECEIVE BY REFERENCE DIRECTIVES? [Y/N]: 


THIS DIRECTIVE ALLOWS A TASK TO OBTAIN A SNAPSHOT OF ITS 
CURRENT VIRTUAL-TO-PHYSICAL ADDRESS SPACE MAPPING. 


DO YOU WANT THE GET MAPPING CONTEXT DIRECTIVE? [Y/N]: 
*UNMAPPED* 


IF ADDRESS CHECKING IS INCLUDED, USER GENERATED ADDRESSES 
PASSED IN EXECUTIVE DIRECTIVES WILL BE SUBJECT TO BOUNDARY, 
ALIGNMENT, AND MODULUS CHECKS. 


DO YOU WANT ADDRESS CHECKING? [Y/N]: 


This feature is automatically included if the target system 
contains a memory management unit. If memory management 
support is included, this question is omitted. 


I/O RUNDOWN INSURES THE INTEGRITY OF AN RSX-11M SYSTEM BY 
MAKING SURE ALL OUTSTANDING TASK RELATED I/O OPERATIONS ARE 
CLEANED UP BEFORE ALLOWING THE TASK TO EXIT. OMISSION OF THIS 
FEATURE SHOULD BE CAREFULLY CONSIDERED. 


**DO YOU WANT I/O RUNDOWN? [Y/N]: 


This feature is automatically included if the target system 
contains a memory management unit. If memory management 
Support is included, this question is omitted. 


Processing continues here whether the system is mapped or 
unmapped. . 


*MAPPED AND UNMAPPED* 


The following two options are available only with RSX-11M 
systems, they are not displayed if you are building an 
RSX-11S system. 


MULTI-USER PROTECTION PREVENTS ONE USER FROM INTEFERING WITH 
THE OPERATION OF ANOTHER BY PROVIDING FOR PUBLIC AND PRIVATE 
DEVICE OWNERSHIP AND LOGON/LOGOFF WITH PASSWORD PROTECTION. 
SELECTION OF THIS FEATURE AUTOMATICALLY INCLUDES TERMINAL 
DRIVER SUPPORT FOR READ WITH SPECIAL TERMINATOR, BREAKTHROUGH 
WRITE, AND READ WITH NO ECHO. 


DO YOU WANT MULTI-USER PROTECTION SUPPORT? [Y/N]: 


It is suggested that you have a minimum of 32K words of 
memory to select multi-user protection support. 


SELECTION OF ANSI MAGTAPE SUPPORT PROVIDES VOLUME AND FILE 
LABELING WHICH CONFORMS TO THE ANSI STANDARD FOR INDUSTRY 
COMPATIBLE TAPE. THIS OPTION REQUIRES EXECUTIVE AST SUPPORT. 
DO YOU WANT ANSI MAGTAPE ACP SUPPORT? [Y/N]: 


The following options are available for both RSX-11M and 
RSX-11S systems. . 
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USER MODE DIAGNOSTIC SUPPORT ENABLES THE EXECUTIVE AND DEVICE 
DRIVERS TO SERVICE SPECIAL I/O FUNCTIONS AND RETURN ADDITIONAL 
DEVICE STATUS INFORMATION AS REQUIRED BY ONLINE DIAGNOSTIC 
TASKS. 


DO YOU WANT SUPPORT FOR ONLINE, USER MODE DIAGNOSTICS? [Y/N]: 


LOADABLE DEVICE DRIVER SUPPORT ALLOWS MOST DEVICE DRIVERS TO BE 
REMOVED FROM THE EXECUTIVE. THEY CAN BE LOADED AND UNLOADED 
ALMOST AT WILL. AT THIS POINT ONLY THE PROCESS CONTROL DRIVERS 
(UDC, ICS/ICR, AND DRS/DSS DRIVERS) AND THE VT11/VS60 GRAPHICS 
DRIVER CAN NOT BE LOADABLE. LOADING OF THE TERMINAL DRIVER IS 
RESERVED FOR VMR LOAD. 


NOTE: LOADABLE DRIVER SUPPORT IN RSX-11S IS LIMITED TO VMR. 
*DO YOU WANT LOADABLE DEVICE DRIVER SUPPORT? [Y/N]: 


AS DISTRIBUTED, THE RSX-11M SOURCE DISK PROVIDES FOR THE 
GENERATION OF AN RSX-11M OR RSX-11S EXECUTIVE THAT CONTAINS 
SUPPORT FOR NETWORK COMMUNICATIONS. IN ORDER TO GENERATE SUCH 
A SYSTEM YOU MUST HAVE THE APPROPRIATE NETWORK SOFTWARE 
LICENSE. 


DO YOU WANT NETWORK ACP SUPPORT? [Y/N]: 


If you select Network ACP support, the following two 
questions are asked. 


DO YOU WANT DECNET VERSION 2 SUPPORT? [Y/N]: 


If you select DECNET Version 2 support, the following is 
displayed. Otherwise, it is omitted. 


WITH THE ADDITION OF VERSION 2 DECNET SUPPORT IT IS NECESSARY 
TO SPECIFY THE HIGHEST VECTOR ADDRESS IN THE SYSTEM SO THAT 
ADEQUATE SPACE IS RESERVED FOR INTERRUPT VECTORS, SINCE V2 
DECNET DEVICES WILL BE SPECIFIED DURING NETGEN RATHER THAN 
SYSGEN. 


WHAT IS THE HIGHEST INTERRUPT VECTOR ADDRESS? [O R: 300-774]: 
DO YOU WANT DECNET VERSION 1 SUPPORT? [Y/N]: 


Network software provides the capability of simultaneously 
operating tasks on different systems to establish logical 
communication links, and to exchange data. If this option 
is not selected, the next seven queries are omitted. 


Users should not attempt to answer the network questions 
without consulting the RSX-11 DECNET-11 Programmer's Guide 
and Reference Manual. 


If Network ACP support and DECNET version 1 support is 
selected, the following ten questions, pertinent only to 
network support, are asked. 


If you do not select DECNET support, the next query 
displayed appears under the heading ALL SYSTEMS. 


*NETWORK ACP SUPPORT ONLY* 


SELECTION OF THIS OPTION PROVIDES SUPPORT FOR THE LOADING OF 
TASKS FROM A MASS STORAGE DEVICE ON ANOTHER SYSTEM. 
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DO YOU WANT SUPPORT FOR REMOTE TASK LOADING? [Y/N]: 


This question is asked only for RSX-11S_ systems. If 
selected, the next question is also asked. 


THIS OPTION ALLOWS TASKS THAT ARE REMOTELY LOADED TO BE 

CHECKPOINTED BY HIGHER PRIORITY TASKS. CHECKPOINT STORAGE 

SPACE IS PROVIDED ON THE HOST MASS STORAGE DEVICE. 

DO YOU WANT REMOTE TASK CHECKPOINTING SUPPORT? [Y/N]: 
Remote task checkpointing on slow communication links can be 
a lengthy process. Selection of this feature should be 
given careful thought. 


The following is displayed only if you selected DECNET 
Version 1 support. 


IN AN RSX-11M SYSTEM THE NETWORK ACP MAY BE OVERLAID. 
OVERLAYING CONSERVES APPROXIMATELY 1K OF MEMORY AT THE COST OF 
A SLIGHT DEGRADATION IN PERFORMANCE. 

SHOULD THE NETWORK ACP BE OVERLAID? [Y/N]: 


The above question is asked only for RSX-11M_ systems. The 
network ACP cannot be overlaid in an RSX-11S system. 


The following question is displayed only if you are 
generating a mapped system. 


IN A MAPPED SYSTEM, THE NETWORK ACP CAN MAP OVER THE I/O PAGE. 
THIS ALLOWS THE ACP TO HAVE AN EXTRA 4K OF BUFFERS, HOWEVER, 
IT RESULTS IN A SLIGHT DEGRADATION OF SYSTEM I/O PERFORMANCE. 
SHOULD THE NETWORK ACP MAP OVER THE I/O PAGE? [Y/N]: 


THIS HARDWARE OPTION PROVIDES EFFICIENT CALCULATION OF MESSAGE 
BLOCK CHECK CHARACTERS. 


DOES THE TARGET SYSTEM HAVE A KG1l CRC OPTION? [Y/N]: 


This option cannot be selected unless the hardware is 
actually present. 


NETWORK MESSAGE TIMEOUT IS PROVIDED TO DETECT COMMUNICATION 
LINK AND REMOTE SYSTEM FAILURES. TYPICAL TIMES (IN SECONDS) 
ARE ON THE ORDER OF TWICE THE LONGEST MESSAGE ROUND TRIP TIME. 
WHAT IS TIMEOUT PERIOD FOR NETWORK MESSAGES? [D R:3.-60.]: 
TYPICAL NETWORK MESSAGE LENGTHS ARE 80. TO 128. BYTES. 
WHAT IS THE MAX NETWORK MESSAGE SIZE IN BYTES? [D R:64.-528.]: 
THE COMMUNICATION BETWEEN TASKS IN A NETWORK IS VIA LOGICAL 
CHANNELS. ONE LOGICAL CHANNEL IS REQUIRED FOR EACH PAIR OF 
COMMUNICATING TASKS. 
HOW MANY CHANNELS CAN BE ACTIVE SIMULTANEOUSLY? [D R:1.-254.]: 
*ALL SYSTEMS* 


IF YOU INTEND TO USE THE K-SERIES LAB PERIPHERALS SUPPORT 
ROUTINES, THE LPA11 LAB. PERIPHERAL ACCELERATOR, THE PRINT 
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SPOOLER, THE FORTRAN ISA PROCESS CONTROL SUBROUTINE CALLS, 
ANSI MAGTAPE, OR UNSOLICITED TERMINAL AST''S, THEN 
ASYNCHRONOUS SYSTEM TRAP PROCESSING SUPPORT IS REQUIRED. 

SEE THE EXECUTIVE REFERENCE MANUAL FOR A DETAILED DESCRIPTION 
OF THE AST FACILITY PROVIDED IN RSX-11M/S. 


DO YOU WANT AST SUPPORT? [Y/N]: 


AST support is included automatically if Floating Point 
Processor, ANSI magtape, or network support is selected. If 
ANSI magtape or network support is selected, this question 
is omitted. 


ABNORMAL TASK TERMINATION AND DEVICE NOT READY MESSAGES ARE 
AUTOMATICALLY PRODUCED BY THE SYSTEM IF THIS OPTION IS 
SELECTED. THIS OPTION IS REQUIRED IF PMD SUPPORT IS DESIRED. 


**DO YOU WANT TASK TERMINATION AND DEVICE NOT READY MESSAGES? [Y/N]: 


If this option is included in an RSX-11M/S system, then the 
Task Termination Notification Task (TKN) must also be 
included in the system for the messages to actually be 
printed. 


IF THE POWER FAILS AND THIS OPTION IS INCLUDED, 
SYSTEM OPERATION IS 
AUTOMATICALLY COMMENCED WHEN POWER IS RESTORED. 


DO YOU WANT POWERFAIL RECOVERY? [Y/N]: 


REQUIRED IF DEC-SUPPLIED PROGRAM DEVELOPMENT SOFTWARE (I1.E., 
TKB, MAC, ETC.) IS TO BE RUN. 


**DO YOU WANT GET PARTITION PARAMETERS DIRECTIVE? [Y/N]: 


THIS DIRECTIVE PROVIDES THE CAPABILITY TO READ THE PROCESSOR 
SWITCH REGISTER AND RETURN ITS CONTENTS TO THE REQUESTING TASK. 
NOTE THAT SOME PROCESSORS DO NOT HAVE A CONSOLE SWITCH REGISTER 
AND, THEREFORE, CANNOT SUPPORT THIS DIRECTIVE. 


DO YOU WANT GET SENSE SWITCHES DIRECTIVE? [Y/N]: 


REQUIRED IF DEC-SUPPLIED PROGRAM DEVELOPMENT SOFTWARE (I.E. 
TKB, MAC, ETC.) IS TO BE RUN. 


**DO YOU WANT GET TASK PARAMETERS DIRECTIVE? [Y/N]: 


THESE DIRECTIVES PROVIDE THE CAPABILITY FOR CO-OPERATING TASKS 
TO COMMUNICATE VIA SYSTEM MAINTAINED MESSAGE QUEUES. IF THE 
TARGET SYSTEM WILL CONTAIN THE PRINT SPOOLER, OR IF LPAI11-K 
POWERFAIL SUPPORT OR ANSI MAGTAPE SUPPORT IS DESIRED, 

THIS OPTION MUST BE INCLUDED. 


DO YOU WANT SEND/RECEIVE DIRECTIVES? [Y/N]: 

THIS DIRECTIVE ALLOWS A TASK TO ALTER ITS OWN OR ANOTHER TASK'S 
PRIORITY AT EXECUTION TIME. ITS INCLUSION WILL ALSO ALLEVIATE 
THE PROBLEMS WITH ABORTED, NON-RESIDENT TASKS. 

DO YOU WANT ALTER PRIORITY DIRECTIVE? [Y/N]: 

THIS DIRECTIVE ALLOWS A TASK TO CONNECT AN INTERRUPT VECTOR 


TO AN INTERRUPT SERVICE ROUTINE IN ITS OWN SPACE. IT IS REQUIRED 
IF K-SERIES LABORATORY PERIPHERALS SUPPORT IS DESIRED. 
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DO YOU WANT CONNECT TO INTERRUPT VECTOR DIRECTIVE? [Y/N]: 


If selected, you must specify the highest vector you plan to 
use. The following note and query is displayed only if the 
connect to interrupt vector directive is selected. 


NOTE: DUE TO AN EXECUTIVE RESTRICTION, YOU ARE 
REQUIRED TO HAVE SUPPORT FOR LOADABLE DRIVERS 
IF YOU DESIRE CONNECT TO INTERRUPT VECTOR 
DIRECTIVE SUPPORT. THIS HAS BEEN SELECTED 
AUTOMATICALLY. 


SINCE THE VECTOR ADDRESSES OF DEVICES THAT WILL BE CONNECTED 
WITH THIS FACILITY ARE NOT SPECIFIED DURING SYSGEN, YOU MUST 
RESERVE SPACE FOR THEIR INTERRUPT VECTORS. 


WHAT IS THE HIGHEST INTERRUPT VECTOR ADDRESS? [O R:300-774]: 


THIS DIRECTIVE ALLOWS A TASK TO INCREASE ITS ADDRESS 
SPACE AT EXECUTION TIME. 


DO YOU WANT EXTEND TASK DIRECTIVES? [Y/N]: 


This feature is only available on systems that include both 
checkpointing and dynamic memory allocation support; 
otherwise, the question is omitted. 


SELECTION OF THIS OPTION WILL SIGNIFICANTLY INCREASE SYSTEM I/0 
THROUGHPUT AT THE EXPENSE OF ADDITIONAL EXECUTIVE CODE. 


DO YOU WANT QUEUE I/O SPEED OPTIMIZATIONS? [Y/N]: 


If Queue I/O speed optimizations are selected, the following 
two questions are asked. 


I/O THROUGHPUT IS ENCHANCED BY PRE-ALLOCATING A NUMBER OF I/0 
PACKETS FROM THE POOL, LEAVING THEM AVAILABLE FOR QUICK USE BY 
QUEUE I/0. 


HOW MANY I/O PACKETS SHOULD BE PRE-ALLOCATED? [D R:1.-15.]: 


AN ADDITIONAL SPEED IMPROVEMENT IS ACHIEVED BY OPTIMIZING DATA 
TRANSFERS IN THE EXECUTIVE MODULE 'BLXIO'. ONE IMPROVEMENT IS 
THE USE OF A SERIES OF 'MOV' INSTRUCTIONS WHICH IS USED IN LIEU 
OF A LOOP. THIS IS CALLED THE DATA TRANSFER VECTOR. 


ENTER SIZE OF DATA TRANSFER VECTOR IN WORDS [D R:4.-33.]: 


The next query is omitted if you are generating an RSX-11S 
system. 


THIS FACILITY OF MCR CAN SUBSTANTIALLY REDUCE THE NUMBER OF 
INSTALLED TASKS NEEDED FOR CONVENIENT SYSTEM OPERATION. SEE 
DESCRIPTION OF THE RUN COMMAND IN THE RSX-11M OPERATOR'S 
PROCEDURES MANUAL FOR DETAILS. 


* DO YOU WANT INSTALL, REQUEST, AND REMOVE ON EXIT SUPPORT? [Y/N]: 


Support for this option is highly recommended if your system 
has limited dynamic memory. 


The install, request, and. remove on exit option is not 
available with RSX-11S systems. 
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LOGICAL DEVICE ASSIGNMENT PROVIDES THE CAPABILITY TO ASSOCIATE 
A LOGICAL NAME TO A PHYSICAL DEVICE UNIT. ASSIGNMENTS MAY BE 
MADE ON A PER TERMINAL OR SYSTEM WIDE BASIS. 


*DO YOU WANT LOGICAL DEVICE ASSIGNMENT SUPPORT? [Y/N]: 


THE NULL DEVICE WILL ALWAYS RETURN THE I/O STATUS FOR SUCCESS- 
FUL COMPLETION FOR AN OUTPUT REQUEST AND END-OF-FILE FOR 

AN INPUT REQUEST. IT IS VERY USEFUL TO ASSIGN IT AS THE OUTPUT 
DEVICE WHEN USING PRE-WRITTEN COMMAND FILES FOR WHICH CERTAIN 
TYPES OF OUTPUT SHOULD BE SURPPRESSED. THE NULL DEVICE DRIVER 
IS NOT LOADABLE 


If you are generating an RSX-11S system without terminals or 
without a disk, a null device is automatically included; a 
null device is generated whether selected or not. 


*DO YOU WANT A NULL DEVICE? [Y/N]: 


If you are generating an RSX-11S system and answered N_ to 
terminal driver support, then the following terminal. driver 
questions are omitted. 


* ALL SYSTEMS EXCEPT RSX-11S WITHOUT TERMINAL DRIVER SUPPORT* 


THE BASELINE TERMINAL DRIVER SUPPLIES A BASIC HALF DUPLEX 
CONNECTION TO TERMINALS INTERFACED BY A DL11, DH11/DM11-BB, 
DJ11, OR DZ11. IT IS THE SMALLEST TERMINAL DRIVER. 


*DO YOU WANT THE BASELINE TERMINAL DRIVER? [Y/N]: 


If multi-uSer protection Support was selected earlier, then 
baseline terminal support cannot be offered; this query is 
omitted. 


If the baseline driver is selected, the next queries, which 
concern user oriented terminal drivers, are bypassed. 


*USER ORIENTED TERMINAL DRIVERS* 


THE USER ORIENTED TERMINAL DRIVER CONTAINS THOSE FEATURES FOUND 
MOST DESIRABLE BY USERS ON A PROGRAM DEVELOPMENT SYSTEM. THE 
FOLLOWING FEATURES ARE INCLUDED: 


~ AUTOMATIC CARRIAGE RETURN/LINE FEED 

- BREAKTHROUGH WRITE 

- TASK CHECKPOINTING DURING TERMINAL INPUT (NEEDS EXEC SUPPORT) 
~ UNSOLICITED INPUT CHARACTER AST (NEEDS EXEC SUPPORT) 
- WRITE WITH CONTROL-O CANCELLATION 

~ CONTROL-R SUPPORT 

- GET TERMINAL CHARACTERISTICS 

- GET TERMINAL DRIVER SUPPORT 

- SETTABLE CASE CONVERSION 

- READ WITH NO ECHO 

- READ AFTER PROMPT 

- SPECIAL CHARACTER LINE TERMINATOR SUPPORT 

~ CRT RUBOUT 

- TERMINAL-HOST SYNCHRONIZATION 

- TRANSPARENT TERMINAL READ/WRITE 

- VARIABLE LENGTH INPUT BUFFERING 


IF MORE OR FEWER FEATURES ARE DESIRED, ANSWER NO. 
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DO YOU WANT THE USER ORIENTED TERMINAL DRIVER? [Y/N]: 
THE TERMINAL DRIVER NORMALLY CONVERTS A FORM FEED INTO 8 LINE 
FEEDS. CHOOSING THE NEXT OPTION WILL SUPPRESS THIS CONVERSION. 


IF YOU HAVE AN LA120 OR LA180S, YOU MUST ANSWER YES TO THE NEXT 
QUESTION. 


DO YOU WANT FORM FEEDS PASSED DIRECTLY TO TERMINALS? [Y/N]: 


IF THE USER ORIENTED TERMINAL DRIVER IS SELECTED, THE NEXT 
19 QUERIES ARE BYPASSED. 


*OPTIONS FOR A USER-TAILORED TERMINAL DRIVER* 
WHEN THIS OPTION IS SELECTED, A CARRIAGE RETURN AND LINE FEED 
WILL BE GENERATED WHENEVER THE TERMINAL BUFFER IS FILLED EITHER 
ON OUTPUT OR ECHO. THE BUFFER SIZE MAY BE EXAMINED OR ALTERED 
BY THE 'SET /BUF' MCR COMMAND. 
DO YOU WANT AUTOMATIC CARRIAGE RETURN/LINE FEED? [Y/N]: 


The following query is omitted if checkpointing support was 
not included in the Executive. 


SELECTION OF THIS OPTION ALLOWS CHECKPOINTABLE TASKS TO BE 
DISPLACED FROM MEMORY DURING TERMINAL INPUT BY HIGHER PRIORITY 
TASKS. THIS OPTION REQUIRES EXECUTIVE CHECKPOINTING SUPPORT. 

DO YOU WANT TASKS TO BE CHECKPOINTABLE DURING TERMINAL INPUT? [Y/N]: 


The following query is omitted if AST support was not 
included in the Executive. 


WHEN ATTACHING A TERMINAL, A TASK CAN SPECIFY AN AST ENTRY 
POINT TO BE USED WHEN AN UNSOLICITED INPUT CHARACTER IS 
RECEIVED. THIS OPTION REQUIRES EXECUTIVE AST SUPPORT. 

DO YOU WANT UNSOLICTED INPUT CHARACTER AST SUPPORT? [Y/N]: 

A WRITE REQUEST ISSUED WITH CONTROL-O CANCELLATION WILL PRINT 
TO THE TERMINAL REGARDLESS OF WHETHER OR NOT THE TERMINAL 
OUTPUT HAS BEEN SUPPRESSED BY CONTROL-O. 

DO YOU WANT WRITE WITH CONTROL~O CANCELLATIONS? [Y/N]: 

TYPING CONTROL-R DURING INPUT CAUSES THE TERMINAL DRIVER TO 
SEND A CARRIAGE RETURN/LINE FEED FOLLOWED BY THE CONTENTS OF 
THE INPUT BUFFER. 

DO YOU WANT CONTROL-R SUPPORT? [Y/N]: 

ESCAPE SEQUENCES WILL BE RECOGNIZED AND TREATED AS LINE 
TERMINATORS FOR SOLICITED INPUT WHICH IS NOT READ-PASS-ALL OR 
READ-WITH-~SPECIAL-TERMINATOR. 

DO YOU WANT ESCAPE SEQUENCE HANDLING? [Y/N]: 

GET MULTIPLE (TERMINAL) CHARACTERISTICS ALLOWS A TASK TO 
DETERMINE MANY OF THE PHYSICAL CHARACTERISTICS (E.G. CRT, 
VT05, SLAVED, ETC) OF INDIVIDUAL TERMINALS. 

DO YOU WANT GET MULTIPLE CHARACTERISTICS SUPPORT? [Y/N]: 


SET MULTIPLE (TERMINAL) CHARACTERISTICS ALLOWS A TASK TO SET 
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AND RESET MANY OF THE CHARACTERISTICS (E.G. CRT, VT0O5, ETC) OF 
ITS TI: TERMINAL. A PRIVILEGED TASK MAY ALSO SET THE CHARAC- > 
TERISTICS OF OTHER TERMINALS IN THE SYSTEM. 


DO YOU WANT SET MULTIPLE (TERMINAL) CHARACTERISTICS SUPPORT? [Y/N]: 


GET TERMINAL DRIVER SUPPORT ALLOWS A TASK TO DETERMINE WHICH OF 
THE OPTIONAL FEATURES WERE CHOSEN FOR THE TERMINAL DRIVER AT 
SYSTEM GENERATION. 


DO YOU WANT GET TERMINAL DRIVER SUPPORT? [Y/N]: 


HOLD-SCREEN SUPPORT ALLOWS TERMINALS (WITH SPECIAL HARDWARE) TO 
BREAK STREAM OUTPUT INTO PAGES THAT FIT ON THE SCREEN. 

ENTERING AN UNSOLICITED CONTROL-C WILL DISABLE HOLD-SCREEN 
MODE. WHEN THIS OPTION IS SELECTED, SUPPORT FOR TRANSPARENT 
READ/WRITE IS AUTOMATICALLY INCLUDED. 


DO YOU WANT HOLD-SCREEN MODE SUPPORT? [Y/N]: 


TERMINAL INPUT IS USUSALLY FILTERED ON BOTH INPUT AND OUTPUT. 
THIS IS NECESSARY TO RECOGNIZE CONTROL CHARACTERS THAT HAVE 
SPECIAL MEANING (I.E. ALTMODE OR ESC) OR REQUIRE FILL 
CHARACTERS (I.E. CARRIAGE RETURN). THIS OPTION PROVIDES 
SUPPORT FOR I/O FUNCTIONS (IO.RAL AND IO.WAL) THAT BYPASS 
CHARACTER FILTERING AND PERMITS OUTPUT OF UP TO 32K BYTES. 


DO YOU WANT TRANSPARENT TERMINAL READ/WRITE SUPPORT? [Y/N]: 


NORMALLY THE TERMINAL DRIVER ACCEPTS AND ECHOS CHARACTERS AS 
RECEIVED. SELECTION OF THIS OPTION PROVIDES THE CAPABILITY TO 
SELECTIVELY ENABLE A TERMINAL SO THAT THE TERMINAL DRIVER WILL 
AUTOMATICALLY CONVERT ALL LOWER CASE INPUT TO UPPER CASE. IT 
ALSO ALLOWS THE RECOGNITION OF BRACE (175) AND TILDE (176) AS 
ASCII CHARACTERS RATHER THAN A FORM OF ALTMODE IF THE TERMINAL 
IS SET TO LOWER CASE. 


DO YOU WANT SETTABLE CASE CONVERSION FOR TERMINAL INPUT? [Y/N]: 


A READ AFTER PROMPT REQUEST ACTS LIKE A WRITE TO THE TERMINAL 
FOLLOWED BY A READ. HOWEVER, THE OVERHEAD OF ONE I/O REQUEST 
AND CONTEXT SWITCHING IS ELIMINATED. IN ADDITION, THE 
EXECUTION WINDOW IS REMOVED BY WHICH ONE TASK CAN PROMPT AND 
ANOTHER TASK INITIATE I/O TO THE TERMINAL BEFORE THE FIRST HAD 
TIME TO ISSUE ITS READ REQUEST, PROVIDED THE TERIMINAL WAS NOT 
ATTACHED. 


DO YOU WANT READ AFTER PROMPT SUPPORT? [Y/N]: 


Multi-user protection support includes support for 
breakthrough write, read with no echo, and read with a 
special terminator. Therefore, if multi-user support was 
selected, the following three questions are omitted. 


A BREAKTHROUGH WRITE REQUEST ISSUED BY A PRIVILEGED TASK WILL 
AUTOMATICALLY PRINT TO THE TERMINAL REGARDLESS OF ITS CURRENT 
OUTSTANDING I/O ACTIVITY. 


DO YOU WANT BREAKTHROUGH WRITE SUPPORT? [Y/N]: 
READ WITH NO ECHO SUPPORT ALLOWS THE READ FUNCTIONS (I0.RLB, 


IO.RVB, AND IO.RPR) TO BE ISSUED SPECIFFYING THAT THE TERMINAL 
INPUT SHOULD NOT BE ECHOED. 
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DO YOU WANT READ WITH NO ECHO SUPPORT? [Y/N]: 


THE LINE TERMINATORS FOR A NORMAL READ ARE ALTMODE OR CARRIAGE 
RETURN. HOWEVER, ANY CHARACTER LESS THAN 40 OCTAL AND GREATER 
THAN 174 OCTAL WILL TERMINATE A READ WITH SPECIAL TERMINATOR 
REQUEST. ESCAPE SEQUENCES CANNOT BE RECOGNIZED IN THIS MODE. 
IN ADDITION, IF THE TERMINAL HAS BEEN SET TO LOWER CASE, ONLY 
177 OCTAL AND CHARACTERS LESS THAN 40 OCTAL ARE TERMINATORS. 


DO YOU WANT READ WITH SPECIAL TERMINATOR SUPPORT? [Y/N]: 


WHEN THIS OPTION IS INCLUDED, RUBOUTS ENTERED ON A CRT TERMINAL 
WILL BE ECHOED AS BACKSPACE-SPACE-BACKSPACE (OR NUMBER THEREOF 
FOR TABS). THIS HAS THE AFFECT OF ERASING THE CHARACTER FROM 
THE SCREEN. 


DO YOU WANT CRT RUBOUT SUPPORT? [Y/N]: 


TERMINAL-HOST SYNCHRONIZATION ALLOWS OUTPUT TO BE TURNED OFF 
(CNTRL-S) AND ON (CNTRL-Q) FROM A TERMINAL. THIS MAY BE USEFUL 
FOR HIGH BAUD RATE DISPLAY TERMINALS AND IS REQUIRED IF THE 
TARGET SYSTEM CONTAINS VT50 TERMINALS WITH THE COPIER OPTION. 


DO YOU WANT TERMINAL-HOST SYNCHRONIZATION SUPPORT? [Y/N]: 


NORMALLY, ALL RECEIVED CHARACTERS ARE STORED IN A BUFFER IN THE 
EXECUTIVE ADDRESS SPACE UNTIL A TERMINATOR CHARACTER IS SEEN. 
AT THAT TIME THE CONTENTS OF THE BUFFER ARE COPIED INTO THE 
REQUESTING TASK'S INPUT BUFFER. SELECTION OF THIS OPTION WILL 
PLACE THE INPUT CHARACTERS DIRECTLY INTO THE TASK BUFFER WHEN > 
THEY ARE RECEIVED, PROVIDED THE TASK IS NOT CHECKPOINTABLE. 


DO YOU WANT USER TERMINAL INPUT BUFFERING? [Y/N]: 


NORMALLY, ALL TERMINAL DRIVER INPUT BUFFERS ARE 80 BYTES LONG. 
THIS IMPLICITLY LIMITS THE SIZE OF THE MAXIMUM TERMINAL INPUT 
REQUEST AS WELL AS THE SIZE OF THE MINIMUM BUFFER ALLOCATION 
FROM DYNAMIC MEMORY. VARIABLE LENGTH BUFFERING ALLOCATES THE 
BUFFERS JUST LARGE ENOUGH TO SATISFY THE READ REQUESTS. THE 
LARGEST BUFFER MAY BE 255 BYTES LONG. 


DO YOU WANT VARIABLE LENGTH TERMINAL INPUT BUFFERING? [Y/N]: 


THE LA30P DECWRITER IS CONNECTED TO THE PDP-1l1 VIA A SINGLE 
BUFFERED INTERFACE. THEREFORE, THE SECOND OF TWO QUICKLY TYPED 
CHARACTERS MAY BE DISCARDED BY THE TERMINAL DRIVER UNLESS THIS 
OPTION IS SELECTED. ALL OTHER COMBINATIONS OF DEC TERMINALS 
AND INTERFACES ARE PROPERLY SUPPORTED BY THE TERMINAL DRIVER. 
THIS OPTION SHOULD BE CHOSEN ONLY IF YOU HAVE AN LA30P | 
TERMINAL. 


DO YOU WANT LA30P SUPPORT? [Y/N]: 

**ALL SYSTEMS ** 
IT IS POSSIBLE TO GENERATE AN EXECUTIVE LARGER THAN 16K TO 
INCREASE THE SIZE OF THE EXECUTIVE DYNAMIC STORAGE REGION. 
DOING THIS WILL REDUCE THE SIZE OF PRIVILEGED TASKS WHICH MAP 
INTO THE EXECUTIVE TO 8K. 
DO YOU WANT SUPPORT FOR A 20K EXECUTIVE? [Y/N]: 


ROUND ROBIN SCHEDULING PROVIDES THE CAPABILITY FOR A GROUP 
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OF TASKS WITHIN A RANGE OF PRIORITIES TO SHARE THE AVAILABLE 
PROCESSING TIME. EACH PRIORITY CLASS WITHIN THE RANGE IS ROUND 
ROBIN SCHEDULED AT EACH SCHEDULE INTERVAL (TIME SLICE). 

DO YOU WANT EXECUTIVE LEVEL ROUND ROBIN SCHEDULING? [Y/N]: 


Round-robin scheduling refers to the algorithm whereby 


each 


task of a group of tasks is successively given preference in 
allocating available processor time. The actual algorithm 
used in RSX-11M is to locate the first task within each 


priority class that is not blocked from executing, and 


to 


move that task to the end of its respective priority class. 
Compute~bound tasks tend to actually round robin, whereas 
I/O-bound tasks tend to remain at the front of their 


respective priority class. 


If Executive level round-robin scheduling is selected, 


you 


must specify a scheduling interval and the range of priority 


classes to be considered. Therefore, the following 
questions are asked. 


If not selected, the next three questions are omitted. 
ROUND ROBIN SCHEDULING IS EXECUTED ON A PERIODIC BASIS. 
A TYPICAL SCHEDULING INTERVAL IS ON THE ORDER OF 100 
MILLISECONDS (6 CLOCK TICKS FOR A 60 CYCLE LINE FREQUENCY 
CLOCK). 
ENTER LENGTH OF SCHEDULE INTERVAL IN TICKS [D R:1.-1000. D:6]: 


ROUND ROBIN SCHEDULING IS EXECUTED FOR A RANGE OF PRIORITY 
CLASSES. TYPICAL RANGES ARE 1. TO 100. 


ENTER HIGHEST PRIOR. CLASS TO BE CONSIDERED [D R:1.-249.]: 
ENTER LOWEST PRIOR. CLASS TO BE CONSIDERED [D R:1.-x]: 


Note that x above is the value of the previous answer. 


three 


To Round-Robin schedule a system that is executing multiple 
copies of the MCR indirect command processor (AT.), the 


response to the above question must be l. 


The following option is not available on systems that do not 


include checkpointing. Therefore, Lt you have 


not 


previously selected checkpointing, the next queries 


concerning disk swapping are omitted. 


THE DISK SWAPPING ALGORITHM PROVIDES FOR THE VARIATION OF A 
RESIDENT TASK'S EFFECTIVE PRIORITY WHEN IT IS BEING CONSIDERED 
FOR CHECKPOINTING. A TASK'S EFFECTIVE PRIORITY IS DETERMINED 
BY BIASING ITS RUN PRIORITY WITH A POSITIVE SWAPPING PRIORITY 
EACH TIME IT IS LOADED INTO MEMORY (E.G., INITIAL TASK LOAD OR 
CHECKPOINT READ). AS THE TASK CONTINUES TO RESIDE IN MEMORY, 
ITS SWAPPING PRIORITY BECOMES NEGATIVE, EVENTUALLY REACHING A 
LOWER BOUND; IT IS THIS BIAS WHICH IS USED TO DETERMINE 
EFFECTIVE PRIORITY. EVENTUALLY, THE TASK BECOMES ELIGIBLE FOR 
CHECKPOINTING BY TASKS OF EQUAL PRIORITY WHICH ARE NOT RESIDENT 
(OR BY LOWER PRIORITY TASKS WITHIN THE SPECIFIED RANGE). 


DO YOU WANT EXECUTIVE LEVEL DISK SWAPPING? [Y/N]: 


If this option is not selected, the next two queries 
omitted. 
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SWAPPING PRIORITIES ARE DECREMENTED ON A PERIODIC BASIS. A 
TYPICAL TIME INTERVAL IS ON THE ORDER OF 500 MILLISECONDS (30 
CLOCK TICKS FOR A 60 CYCLE FREQUENCY CLOCK). TYPICALLY, THE 
SWAPPING INTERVAL SHOULD BE AT LEAST 5 TIMES THE ROUND ROBIN 
SCHEDULING INTERVAL. 


ENTER LENGTH OF SWAPPING INTERVAL IN TICKS [D R:1.-5000. D:5.]: 


WITH A SWAPPING PRIORITY OF "S", A TASK RUNNING AT PRIORITY "P" 
WILL HAVE AN EFFECTIVE PRIORITY RANGE (FOR CHECKPOINTING) FROM 
"P+S" TO "P-S" AS LONG AS IT RESIDES IN MEMORY. THE SWAPPING 
PRIORITY DETERMINES THE RANGE OVER WHICH LOWER PRIORITY TASKS 
MAY CHECKPOINT HIGHER ONES: THE LARGER THE SWAPPING PRIORITY, 
THE GREATER THE RANGE. 


A TYPICAL VALUE FOR THIS PARAMETER IS 5. 

WHAT IS THE SWAPPING PRIORITY? [D R:1.-20. D:5.]J: 

ADDITION OF A USER WRITTEN DRIVER REQUIRES THAT ADEQUATE SPACE 
BE ALLOCATED FOR INTERRUPT VECTORS DURING THE ASSEMBLY OF THE 
GENERATED EXECUTIVE. ACTUAL DRIVER INCLUSION OCCURS WHEN THE 
TARGET EXECUTIVE IS BUILT. 


ARE YOU PLANNING TO INCLUDE A USER WRITTEN DRIVER? [Y/N]: 


If a user-written driver is not being incorporated, the next 


three queries are omitted. 
WHAT IS THE HIGHEST INTERRUPT VECTOR ADDRESS? [O R: x-774]: 


The low range for the highest interrupt vector address x 


either 300 or the value that was specified in the response 


to the query concerning the highest interrupt vector 


plan to use. If your response is greater than the low range 


argument, the highest interrupt vector address is 


increased. This is done to prevent the Executive stack from 
overwriting the vector addresses (including the vector 


addresses needed for user-written drivers). 


THE EXECUTIVE ROUTINES SGTWRD AND SPTWRD ARE USED BY DRIVERS TO 
TRANSFER A WORD FROM (OR TO) A USER SPECIFIED BUFFER. THEIR 
INCLUSION IS OPTIONAL SINCE ONLY ONE OR TWO OF THE DEC SUPPLIED 
DRIVERS USE THEM. 


DO YOU REQUIRE THE EXECUTIVE ROUTINE $GTWRD? [Y/N]: 

DO YOU REQUIRE THE EXECUTIVE ROUTINE $PTWRD? [Y/N]: 

THE EXECUTIVE DEBUGGING TOOL PROVIDES A SUBSET ODT-11 THAT RUNS 
AS A PART OF THE RSX-11M EXECUTIVE. THIS TOOL ALLOWS 
INTERACTIVE DEBUGGING OF EXECUTIVE MODULES, I/O DRIVERS, AND 
INTERRUPT SERVICE ROUTINES. SELECTION OF THIS OPTION ALSO 
INCLUDES CONSISTENCY CHECK CODE IN THE DYNAMIC MEMORY ROUTINES. 
DO YOU WANT TO INCLUDE THE EXECUTIVE DEBUGGING TOOL? [Y/N]: 


See the RSX-11M Guide to Writin an 1/0 Driver for 


description of xXDT. At the expense of additional overhead 
code in the Executive module CORAL, selection of this option 
also includes consistency checking when deallocating dynamic 
memory. Since errors in deallocation (via I/O done, etc.) 
are common causes of system crashes, the overhead in a 


system debugging situation may be justified. 
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IF THE SYSTEM CRASHES AND THIS OPTION IS INCLUDED, THE 
EXECUTIVE STACK AND REGISTERS WILL BE DUMPED TO THE SELECTED 
DEVICE. 


DO YOU WANT REGISTER AND STACK DUMP AT SYSTEM CRASH? [Y/N]: 


If this option is selected, you are required to specify the 
CSR address of the device. Thus, the following question is 
asked. 


If you do not select this option, the Executive stack and 
registers are not dumped upon a system crash. The following 
question is not displayed. 


THE DEVICE ON WHICH THE STACK AND REGISTER DUMP APPEARS 
MUST BE A TERMINAL OR LINE PRINTER COMPATIBLE DEVICE; THAT 
IS, IT MUST RECEIVE A SINGLE BYTE AT A TIME. THE NORMAL 
DEVICE IS THE CONSOLE TERMINAL WHICH HAS A CSR ADDRESS OF 
177564. 


ENTER DUMP DEVICE CSR ADDRESS [0 R:160000-177700 D:177564]: 


SELECTION OF THIS OPTION INCLUDES CODE TO DUMP MEMORY TO 
SECONDARY STORAGE FOR LATER ANALYSIS BY THE CRASH DUMP 
ANALYSIS PROGRAM. THE CRASH DUMP DEVICES SUPPORTED ARE: 
DT, DK, MT, AND MM. 


DO YOU WANT CRASH DUMP ANALYSIS SUPPORT? [Y/N]: 


If this option is selected, you must specify the CSR address 
of the output device, the device mnemonic on which memory is 
to be dumped, its CSR address, and the physical unit number. 
Thus, the following four questions are asked. 


If not selected, the next four quesitons are not displayed. 
THE DEVICE ON WHICH THE CRASH NOTIFICATION APPEARS MUST BE A 
PAPER TAPE, TELETYPE, OR LINE PRINTER COMPATIBLE DEVICE; THAT 
IS, THE DEVICE MUST RECEIVE A SINGLE BYTE AT A TIME. THE 


NORMAL CRASH OUTPUT DEVICE IS THE CONSOLE TERMINAL WHICH HAS A 
CSR ADDRESS OF 177564. 


IN RESPONSE TO THE NEXT QUESTION, ENTER THE CSR ADDRESS OF THE 
DEVICE ON WHICH THE CRASH NOTIFICATION IS TO APPEAR. 


ENTER OUTPUT DEVICE CSR ADDRESS [O R: 160000-177700 D:177564]: 


MEMORY CAN BE DUMPED ONTO ANY OF THE FOLLOWING DEVICES: 
DT, DK, MT, MM 


ENTER CRASH MEMORY DUMP DEVICE MNEMONIC? [S]: 


In the next query, it is assumed that DT was entered as_ the 
memory dump device. 


WHAT IS ITS CSR ADDRESS? [O R: 160000-177700 D:177342]: 
Since it was assumed that DT was the memory dump device, the 
default argument for the CSR address is 177342. Note that 


in an actual SYSGEN, the default argument is the standard 
CSR address of your memory dump device. 
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WHAT IS THE PHYSICAL UNIT NUMBER OF CRASH UNIT? [O R: 0-7 D:0]: 


The panic dump routine is not available if crash dump 
analysis support was selected. Therefore, if you selected 


crash dump analysis support, the following questions 
omitted. 


SELECTION OF THIS OPTION INCLUDES CODE TO DUMP SELECTED 
PORTIONS OF MEMORY TO A HARD COPY DEVICE. THE DEVICE MUST 
RECEIVE A BYTE AT A TIME (I.E. A TERMINAL OR LINE PRINTER). 
THE DEFAULT DEVICE IS THE LINE PRINTER. 


DO YOU WANT THE PANIC DUMP ROUTINE? [Y/N]: 


are 


If this option is omitted and a system failure should occur, 
it may not be possible for the user to capture vital data on 


the state of the system at failure time. 


The panic dump routine is normally used in debugging 


drivers or privileged tasks. It provides a means 


new 


of 


generating a formatted dump of memory on a line printer or a 
terminal. If the dump routine query is not selected, then 


the next two queries will not appear. 
ENTER THE DUMP DEVICE CSR ADDR? [O R: 160000-177700 D:177514]: 


The device that the formatted dump appears must be a 
tape, terminal, or line printer compatible device; 


paper 


the 


device must transmit a single byte at a time. The normal 


crash dump device is a line printer (CSR address 177514). 


IF YOUR PROCESSOR DOES NOT HAVE A CONSOLE SWITCH REGISTER, THE 
PANIC DUMP ROUTINE MUST INPUT ITS DUMP ADDRESS LIMITS FROM 
LOCATION ZERO RATHER THAN FROM THE CONSOLE SWITCHES. 


DOES YOUR PROCESSOR HAVE A CONSOLE SWITCH REGISTER? [Y/N]: 


Error logging is not available on an RSX-11S system; 
following is not displayed. 


The error logging queries are only displayed if you 
generating an RSX-11M system. 


SELECTION OF ERROR LOGGING WILL CAUSE DISK AND TAPE DEVICE . 
ERRORS TO BE INTERCEPTED AND INFORMATION CONCERNING THEM TO BE 
WRITTEN INTO A DISK FILE FOR LATER ANALYSIS. NOTE THAT THIS 
OPTION AUTOMATICALLY INCLUDES SUPPORT FOR CHECKPOINTING AND THE 
SEND/RECEIVE DIRECTIVES. 


DO YOU WANT DEVICE ERRORS AND TIMEOUTS LOGGED? [Y/N]: 


SELECTION OF THIS OPTION ALLOWS THE EXECUTIVE TO DETECT THE 
OCCURRENCE OF TRAPS TO UNUSED INTERRUPT VECTORS AND TO STORE 
INFORMATION ABOUT THEM IN A FILE FOR LATER ANALYSIS. INCLUDING 
THIS OPTION ALSO REQUIRES SUPPORT FOR SEND/RECEIVE DIRECTIVES 
AND CHECKPOINTING. 


DO YOU WANT UNDEFINED INTERRUPTS LOGGED? [Y/N]: 


SELECTION OF THIS OPTION WILL CAUSE CACHE AND MEMORY PARITY 
ERROR TRAPS FROM USER TASKS TO BE INTERCEPTED WITH INFORMATION 
CONCERNING THEM TO BE WRITTEN INTO A FILE FOR LATER ANALYSIS. 
NOTE THAT THIS OPTION ALSO INCLUDES SUPPORT FOR PARITY MEMORY, 
CHECKPOINTING, AND THE SEND/RECEIVE DIRECTIVES. 
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DO YOU WANT PARITY ERROR TRAPS LOGGED? [Y/N]: 


A NON ZERO RESPONSE TO THIS QUERY IS REQUIRED. A MINIMUM OF 
256 WORDS WILL BE ACCEPTED TO INSURE MINIMUM OPERATIONS. 1024 
WORDS IS A REASONABLE ESTIMATE FOR ADEQUATE PERFORMANCE OF A 
SET OF USER TASKS MAKING FULL USE OF THE BASELINE SYSTEM. 


RESPONSE LIMITS: 256.-16384. MINUS SIZE OF EXECUTIVE 


**ENTER SIZE OF DYN. STORAGE REGION IN WORDS (D R: 256.-16384.]: 


The amount of dynamic memory needed depends 


configuration of the machine and the number of tasks 
installed. See Appendix B for a complete description. 
in mind that it is advisable to answer this question 


conservatively. This will ensure that the size 


executive will not exceed pre-established size goals. 
the Executive is built, additional pool may be allocated 


when configuring the system with VMR. 


IF SELECTED, THE SYSTEM WILL, WHEN IDLE, CAUSE THE DATA LIGHTS 


TO FLICKER IN A PRONOUNCED CIRCULAR ROTATION. THE OPTION 
FUNCTIONS PROPERLY ONLY ON PDP-11/45/50/55/70 SYSTEMS. 


DO YOU WANT ROTATING PATTERN IN DATA LIGHTS? [Y/N]: 
END EXECUTIVE SERVICE OPTIONS. 
BEGIN PROCESSOR OPTIONS. 


THE PDP-11/70 REQUIRES ADDITIONAL EXECUTIVE SUPPORT IF YOU 
WISH TO UTILIZE MEMORY ABOVE 124K. 


IS YOUR TARGET PROCESSOR A PDP-11/70? [Y/N]: 


THE MINIMUM MEMORY IS 16K FOR AN RSX-11M SYSTEM AND 8K FOR AN 
RSX-11S SYSTEM. THE MAXIMUM MEMORY SIZE IS 1920K FOR AN 
RSX-11M SYSTEM AND 124K FOR AN RSX-11S SYSTEM. IN ORDER TO 
UTILIZE MEMORY ABOVE 28K THE TARGET SYSTEM MUST CONTAIN A 
MEMORY MANAGEMENT UNIT. 


If your target processor is not an 11/70, the high value for 


the range argument is 124K. 


If it is an 11/70, the high value is 1920K. 


Regardless of the target processor, if you have not selected 
memory management, the maximum size of physical memory is 


28K. 


In the next question, it is assumed that the processor is an 
11/70, the memory management option was selected, and an 


RSX-11M system is being generated. 


* ENTER SIZE OF PHYS. MEMORY IN 1024 WORD BLOCKS [D R: 16.-1920.]: 


Note that the range argument is dependent upon whether or 
not the target processor is an 11/70, memory management was 
selected, and an RSX-11M system is being generated. 


If you do not have memory management and/or specified a size 
for physical memory less than 124K (a target processor other 
than an 11/70), the next two questions are asked. 
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If. you have memory management, the following two questions 
are omitted; the next question asked concerns floating 
point support. 


RSX-11M/S IS CAPABLE OF RUNNING ON ALL PDP-11 PROCESSORS. THE 
LSI-11 IS THE SMALLEST MEMBER OF THE PDP-11 FAMILY OF 
PROCESSORS AND IS CONSTRUCTED USING LARGE SCALE INTEGRATED 
CIRCUIT TECHNOLOGY. THE PDP-11/03 IS THE PACKAGED VERSION OF 
THE LSI-11 PROCESSOR. 


IS THE TARGET PROCESSOR AN LSI~-11 OR PDP-11/03? [Y/N]: 


If this query is answered affirmatively, the next question 
asked concerns FIS support; EAE and floating point support 
are not available on an LSI-ll or PDP-11/03. 


THE EXTENDED ARITHMETIC ELEMENT (EAE) (KE11-A/B) IS AN OPTION 
WHICH PERFORMS MULTIPLICATION, DIVISION, MULTIPLE POSITION 
SHIFTS AND NORMALIZATION SIGNIFICANTLY FASTER THAN SOFTWARE 
ROUTINES. IT CONNECTS DIRECTLY TO THE UNIBUS AND IS PROGRAMMED 
AS A PERIPHERAL, ALLOWING OVERLAP BETWEEN CPU AND EAE 
OPERATIONS. 


DO YOU WANT EAE SUPPORT? [Y/N]: 
If answered affirmatively, the next query is omitted. 


The following question is asked if the system contains 
memory management support. 


It is also asked if EAE support was not selected. 


THE PDP-11 FLOATING POINT PROCESSOR IS AN OPTIONAL ARITHMETIC 
PROCESSOR. IT PERFORMS ALL FLOATING POINT ARITHMETIC 

OPERATIONS AND CONVERTS DATA BETWEEN INTEGER AND FLOATING POINT 
FORMATS. THIS OPTION IS AVAILABLE ON THE PDP 11/34/45/50/55, 

60 AND 70. THIS SHOULD NOT BE CONFUSED WITH THE FIS 

(FLOATING INSTRUCTION SET) OPTION AVAILABLE WITH THE PDP11/40. 


DO YOU WANT FLOATING POINT PROCESSOR SUPPORT? [Y/N]: 

If you answer affirmatively the FIS query is omitted. 
THE FIS OPTION (WHICH REQUIRES THE EIS OPTION) INCLUDES 
HARDWARE FLOATING POINT ADD, SUBTRACT, MULTIPLY, AND DIVIDE 
INSTRUCTIONS. 
DO YOU WANT FIS SUPPORT? [Y/N]: 


The following query, and the associated number of 
interrupts, is omitted if the target processor is an LSI-ll. 


RSX-11M/S REQUIRES A REAL-TIME CLOCK FOR ITS OPERATION. EITHER 
THE KW11-P PROGRAMMABLE FREQUENCY CLOCK OR KW11-L LINE 


FREQUENCY CLOCK OR THE DL11-W LINE FREQUENCY CLOCK/CONSOLE 
INTERFACE MAY BE USED. 


DO YOU HAVE A PROGRAMMABLE CLOCK? [Y/N]: 
If the answer is affirmative, the next question is asked. 


THE NUMBER OF INTERRUPTS SPECIFIED MUST BE EVENLY DIVISIBLE 
INTO 10000(10). 
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WHAT IS THE NUMBER OF INTERRUPTS PER SECOND? [D R: 1.-1000.]: 


Specifying the number of clock interrupts to be greater than 
100. per second should be considered carefully, because it 
adds significant system overhead. 


LINE FREQUENCY IS EITHER 50. OR 60 HERTZ. IN THE U.S.A. LINE 
FREQUENCY IS ALWAYS. 60 HERTZ. . 


IS YOUR LINE FREQUENCY 50 HERTZ? [Y/N]: 


THE KW11-Y IS A WATCHDOG TIMER THAT IS CONSTANTLY ATTEMPTING TO 
TIME OUT SYSTEM ACTIVITY. THE RSX-11M/S EXECUTIVE REFRESHES 
THE TIMER AT EVERY CLOCK INTERRUPT. IF THE SYSTEM FAULTS OR A 
HARDWARE FAILURE OCCURS AND THE TIMER ELAPSES AN EXTERNAL 
SIGNAL IS GENERATED. 


DO YOU WANT KW11-Y WATCHDOG TIMER SUPPORT? [Y/N]: 


If this option is selected, the generated system will only 

run on configurations that contain a KW11-Y. An attempt to 
boot such a system on a configuration not having the KWl1-Y 
will result in an immediate system crash. 


PARITY MEMORY PROVIDES CIRCUITRY TO CHECK THE INTEGRITY OF 
STORED DATA. PARITY CHECKING BITS ARE GENERATED WHEN DATA 
WORDS ARE WRITTEN INTO MEMORY AND CHECKED WHEN THE DATA WORDS 
ARE SUBSEQUENTLY READ OUT OF MEMORY. 


DO YOU WANT PARITY MEMORY SUPPORT? [Y/N]: 


If error logging of parity errors was selected earlier, this 
option has been included already; the question is omitted. 


The parity memory option provides the system with detection 
of errors in the memory system. If this query is answered 
affirmatively, the next question is asked. 


. However, if it is known already that the target processor is 
a PDP-11/70 (by specifying physical memory greater than 124K 
earlier), then the following query is omitted. 


THE PDP-11/70 PROVIDES ADDITIONAL PARITY CHECKING CIRCUITRY. 
THE BUFFER MEMORY (CACHE) USED TO SPEED UP MAIN MEMORY 
OPERATIONS IS ALSO CAPABLE OF GENERATING AND CHECKING PARITY. 


DOES THE TARGET PROCESSOR HAVE A CACHE MEMORY? [Y/N]: 
END PROCESSOR OPTIONS 
BEGIN PERIPHERAL OPTIONS 


Selection of a peripheral option (nonzero response to_ the 
query) will require the user to enter information concerning 
the device. This information pertains to the device's 
vector and CSR addresses and, if loadable driver support has 
been selected, whether or not the driver is to be loadable. 


If the reply to the query for the number of the specific 
peripherals that are in your system is greater than one, the 
vector address query is repeated. The second and. subsequent 
displays require an interrupt vector. 
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The CSR query appears aS many times as the number of 
peripheral's specified. Note that the queries for the 
interrupt vector and CSR occur one after the other for each 
peripheral. The repeat sequence repeats both queries. 


* EXPANDED COMMENTS DESIRED FOR PERIPHERAL OPTIONS? [Y/N]: 
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Once long dialogue is chosen, the explanatory text is 
displayed prior to each peripheral option query and cannot 
be suppressed (except on a per query basis with CTRL/O). 
Selective short dialogue produces explanatory text following 
the query only when that query has been answered using 
ALTMODE/ESCAPE. 


It is assumed that expanded comments were selected. 


If loadable driver support was selected, you have the option 
of designating drivers as loadable or resident. For each 
device to be included in the system (except ICS/ICR, UDC, 
DRS/DSS, and VT11/VS60), a loadable driver question is 
asked. Answer Y for loadable drivers, and N or a carriage 
return for resident drivers. 


WRITECHECK INCREASES THE DATA RELIABILITY OF DISKS AT THE 
COST OF A DEGRADATION IN DISK THROUGHPUT. WRITECHECK, IF 
SELECTED, MAY BE ENABLED/DISABLED DYNAMICALLY ON A PER DRIVE 
BASIS VIA THE MCR SET COMMAND. 


WRITECHECK IS CURRENTLY SUPPORTED FOR ALL DISKS EXCEPT THE RLO1 
AND RX01l. 


DO YOU WANT DISK WRITECHECK SUPPORT? [Y/N]: 


Write check is the process where the driver performs a_ read 
after each write. If the data canot be read or does not 
match the data written, the data is rewritten and another 
read attempt is performed. 


PROCESS I/O AND LABORATORY PERIPHERALS CONSIST OF THE FOLLOWING: 


ADO1-D MULTICHANNEL ANALOG DATA ACQUISITION OPTION 
AFC11 DIFFERENTIAL ANALOG INPUT SUBSYSTEM 

AR11 LABORATORY PERIPHERAL SYSTEM 

LPA11 LABORATORY PERIPHERAL ACCELERATOR SUBSYSTEM 
LPS11 LABORATORY PERIPHERAL SYSTEM 

ICS11/ICR11 INDUSTRIAL CONTROL SUBSYSTEMS 

UDC11 UNIVERSAL DIGITAL CONTROLLER 

DRS/DSS DIGITAL I/O MODULES 


HAVE ANY PROCESS I/O OR LABORATORY PERIPHERALS? [Y/N]: 


Note that because K-series peripheral support does not 
require a device driver, they are not included in the above 
list. 


If you answer Y to this question, the following queries 
concerning the above process I/O peripherals are asked. If 
you do not have any process I/O peripherals, skip this 
section and continue reading from the CM/CR11 card reader 
section (under the heading ALL SYSTEMS). 


If loadable driver support was selected, you have the option 
of designating drivers as loadable or resident. For each 
device to be included in the system (except ICS/ICR, UDC, 
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DRS/DSS, and VT11/VS60), a loadable driver question is 
asked. Answer Y for loadable drivers, and N or ae carriage 
return for resident drivers. 


Selection of a peripheral option (nonzero response to the 
query) will require the user to enter information concerning 
the device. This information pertains to the device's 
vector and CSR addresses and, if loadable driver support has 
been selected, whether or not the driver is to be loadable. 


If the reply to the query for the number of the specific 
peripherais that are in your system is greater than one, the 
vector address query is repeated. The second and subsequent 
displays require an interrupt vector. 


The CSR query appears as many times as the number of 
peripherals specified. Note that the queries for the 
interrupt vector and CSR occur one after the other for each 
peripheral. The repeat sequence repeats both queries. 


**PROCESS I/0 AND LAB PERIPHERALS** 


THE ADO1-D IS A MULTICHANNEL ANALOG DATA ACQUISITION OPTION 
WHICH INTERFACES DIRECTLY TO PDP-11 COMPUTERS. 


THE STANDARD ADO01-D CONSISTS OF AN EXPANDABLE SOLID-STATE INPUT 
MULTIPLEXER, PROGRAMMABLE INPUT RANGE SELECTOR, A/D CONVERTER, 
CONTROL, AND BUS INTERFACE. THE MULTIPLEXER CAN BE EXPANDED BY 
ADDING 4-CHANNEL MODULES UP TO 32 CHANNELS. AN EXPANSION 
MULTIPLEXER MAY BE ADDED TO PROVIDE A MAXIMUM CONFIGURATION OF 
64 CHANNELS. 


HOW MANY ADO1-D A/D CONVERTERS DO YOU HAVE? [D R: 0.-16.]: 

ENTER CSR ADDR. OF THE NEXT ADO1 [0 R:; 160000-177700 DL176770]: 

HOW MANY A/D CHANNELS DOES IT HAVE? [D R:1.-64.]: 
This query appears as many times as the number of ADO1-Ds 
specified. Note that the queries for the CSR, and the 
number of channels occur one after the other for each 
ADO1-D. The repeat sequence repeats both of the queries. 

THE AFC11 IS A DIFFERENTIAL ANALOG INPUT SUBSYSTEM FOR 

IDACS-11 INDUSTRIAL CONTROL SYSTEMS. THE AFC11 SYSTEM 

MULTIPLEXES UP TO 1024 DIFFERENTIAL INPUT ANALOG SIGNALS, 

SELECTS GAIN, AND PERFORMS A 13-BIT ANALOG-TO-DIGITAL 

CONVERSION AT A 200 CHANNEL PER SECOND RATE UNDER PROGRAM 

CONTROL. 

HOW MANY AFC1il A/D CONVERTERS DO YOU HAVE? [D R: 0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT AFC11? [O R: 60-774 D:134]: 

WHAT IS ITS CSR ADDRESS? [0 R: 160000-177700 D:172570]: 

HOW MANY A/D CHANNELS DOES IT HAVE? [D R:1.-1024.]: 

THE AR11 LAB PERIPHERAL SYSTEM IS A LOW-COST REALTIME SUBSYSTEM 

WHICH INTERFACES TO THE PDP-11 FAMILY OF COMPUTERS. THE SYSTEM 


INCLUDES A 10-BIT A/D CONVERTOR, PROGRAMMABLE REALTIME CLOCK, 
AND DISPLAY CONTROL. 
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HOW MANY AR11 LAB PERIPHERAL SYSTEMS DO YOU HAVE? [D R: 1-1024.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


THE CLOCK VECTOR ADDRESS FOR THE AR11 IS ASSIGNED FROM THE 
FLOATING VECTOR SPACE STARTING AT 300. IT IS LOCATED AT AN 
OFFSET OF FOUR (4) FROM THE BEGINNING OF THE AR11 VECTOR SPACE. 
CONSULT FIELD SERVICE TO DETERMINE LOCATION IF UNKNOWN. 


ENTER CLOCK VECTOR ADDRESS OF THE NEXT AR11 [O R:300-774]: 


For the AR11 driver to operate properly, the interrupt 
vector of its real-time clock must be specified. If the 
number of ARlls specified was greater than 1, this query is 
repeated by SGN for each ARI1l. 


170400 IS THE STANDARD CSR ADDRESS FOR THE AR11. THE ADDRESS 
REQUIRED HERE IS THAT OF THE FIRST WORD OF THE AR11 CSR GROUP. 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:170400]: 


THE POLARITY MASK WORD CORRESPONDS ONE-TO-ONE WITH THE 16 
POSSIBLE CHANNELS. A 1-BIT DESIGNATES A UNI-POLAR CHANNEL. 
A O-BIT DESIGNATES A BI~POLAR CHANNEL. 


WHAT IS THE POLARITY MASK WORD? [O]: 
IS THE D/A OPTION PRESENT? [Y/N]: 


Although the AR11 module includes a D/A converter, support 
for the D/A is optional in the driver. If D/A support is 
not chosen, the driver will be significantly shorter. 


THE QUERY RESPONSE VALUE MUST BE EVENLY DIVISIBLE INTO 10000. 
ENTER MAXIMUM NUMBER OF SAMPLES PER SECOND [D R:1.-2500.]: 


THE AR11 DOES NOT INCLUDE THE 16-BIT DIGITAL I/O OPTION THAT IS 
AVAILABLE WITH THE LPS11. THE SAME FUNCTIONALITY, HOWEVER, MAY 
BE ACHIEVED BY USING A DR11-K THAT IS JUMPER SELECTED TO USE 

THE 16 INDIVIDUAL INPUT LINES WITHOUT INTERRUPTS. 


IS THE DR11-K OPTION PRESENT? [Y/N]: 


This query appears aS many times as the number of ARI1ls 
specified. Note that the queries for interrupt vector, CSR, 
polarity mask word, D/A option, maximum sample rate, and 
DR11-K option occur one after the other for each AR11. The 
repeat sequence repeats all six queries. If this question 
is answered affirmatively, then the next question is also 
asked. 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:170420]: 

THE LPA11 LAB PERIPHERAL ACELERATOR IS A REAL-TIME SUBSYSTEM WHICH 
INTERFACES TO THE PDP-11 FAMILY OF COMPUTERS. THE SYSTEM CONSISTS 
OF THE LPA-1l1, UP TO 2 A/D CONVERTERS, A PROGRAMMABLE REAL-TIME 
CLOCK, A D/A CONVERTER, AND UP TO FIVE DIGITAL I/O MODULES. 


HOW MANY LPA11-K LAB SUBSYSTEMS DO YOU HAVE: [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


LPA11'S ARE ASSIGNED VECTORS FROM THE FLOATING VECTOR SPACE. CONSULT 
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FIELD SERVICE TO DETERMINE THE LOCATION IF UNKNOWN. 
ENTER VECTOR ADDRESS OF THE NEXT LPA11 [O R:300-774]: 


170460 IS THE STANDARD CSR ADDRESS FOR THE FIRST LPA11. NOTE THAT 
THE ADDRESS REQUIRED IS THAT OF THE FIRST WORD OF THE LPA11 CSR 
GROUP. CONSULT FIELD SERVICE TO DETERMINE ITS LOCATION IF UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R:160200-177700 D:170460]: 


THE LPS11 LAB PERIPHERAL SYSTEM IS A REAL-TIME SUBSYSTEM WHICH 
INTERFACES TO THE PDP-11l FAMILY OF COMPUTERS. THE SYSTEM 
HOUSES A 12-BIT A/D CONVERTOR, PROGRAMMABLE REAL-TIME CLOCK, 
DISPLAY CONTROLLER AND A 16-BIT DIGITAL I/O OPTION. 


HOW MANY LPS11 LAB. PERIPHERAL SYSTEMS DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


THE CLOCK VECTOR ADDRESS FOR THE LPS11 IS ASSIGNED FROM THE 
FLOATING VECTOR SPACE STARTING AT 300. IT IS LOCATED AT AN 
OFFSET OF FOUR (4) FROM THE BEGINNING OF THE LPS11 VECTOR 
SPACE. CONSULT FIELD SERVICE TO DETERMINE THE LOCATION IF 
UNKNOWN. 


ENTER CLOCK VECTOR ADDRESS OF THE NEXT LPS11 [O R:300-774]: 


170406 IS THE STANDARD CSR ADDRESS FOR THE LPS11. NOTE THAT THE 
ADDRESS REQUIRED IS THAT OF THE FIRST WORD OF THE LPS11 CSR 
GROUP. 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:170400]: 
HOW MANY A/D CHANNELS DOES IT HAVE? [D R:1.-64.]: 
IS THE GAIN RANGING OPTION PRESENT? [Y/N]: 


If the gain ranging option is present, you are asked to 
identify the polarity mask word and whether or not bandwidth 
filtering is enabled. Otherwise, the next three queries are 
skipped. 


THE POLARITY MASK WORD CORRESPONDS ONE-TO-ONE WITH THE 16 
POSSIBLE CHANNELS. A 1-BIT DESIGNATES A UNI-POLAR CHANNEL. A 
O-BIT DESIGNATES A BI-~POLAR CHANNEL. 


WHAT IS THE POLARITY MASK WORD? [0]: 
DO YOU HAVE BANDWIDTH FILTERING ENABLED? [Y/N]: 


If bandwidth filtering is enabled, the following query 
concerning the channel select delay is asked; otherwise it 
is omitted. 


WITH BANDWIDTH FILTERING ENABLED, THE LPS11 DRIVER MUST IMPOSE 
A SOFTWARE DELAY BETWEEN THE TIME IT CHANGES CHANNELS ON THE 
MULTIPLEXER AND THE TIME IT INITIATES THE A/D CONVERSION. THIS 
DELAY PERIOD CAN RANGE FROM 85 USEC TO 8.5 MSEC. CONSULT THE 
LPS11 LABORATORY PERIPHERAL SYSTEM USER'S GUIDE FOR THE PROPER 
DELAY FOR YOUR APPLICATION. 


NOTE THAT THE RESPONSE MUST BE IN 100 USEC UNITS, I.E. SPECIFY 
25 TO DELAY 2.5 MSEC. 


ENTER CHANNEL SELECT DELAY (IN 100 USEC UNITS) [D R:1.-85.]: | 


Whether or not gain ranging is present, you are asked if the 
D/A option is present. 
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IS THE D/A OPTION PRESENT? [Y/N]: 
If it is present, you must enter the number of D/A channels. 
HOW MANY D/A CHANNELS DOES IT HAVE? [D R:1.-10.]: 


The first two D/A channels correspond to the xX and Y 
registers of the display controller. Up to eight additional 
D/A channels may be specified if the external D/A option is 
present. 


THE LPSDR-A DIGITAL I/O AND RELAY MODULE IS SUPPORTED AS AN 
OPTION BY THE LPS11 DRIVER. 


IS THE DIGITAL I/O AND RELAY OPTION PRESENT? [Y/N]: 
THE QUERY RESPONSE VALUE MUST BE EVENLY DIVISIBLE INTO 10000. 
ENTER MAXIMUM NUMBER OF SAMPLES PER SECOND [D R:1.-2500.]: 


Selection of ICS/ICR-11l support precludes UDC-11l support; 
ICS/ICR-11 and UDC-11 are mutually exclusive. 


THE ICS-11 AND ICR-11 ARE PROCESS I/O SUBSYSTEMS WHICH PROVIDE 
ANALOG AND DIGITAL INTERFACE CAPABILITIES BETWEEN THE PDP-11 
COMPUTER SYSTEMS AND TYPICAL INDUSTRIAL INSTRUMENTATION AND 
TRANSDUCERS. THE ICS-11 IS A LOCAL SUBSYSTEM FOR DIRECT 
CONNECTION TO THE PDP-11 UNIBUS. THE ICR-1l IS CONNECTED TO 
THE PDP-1l BY A HIGH-SPEED SERIAL LINE WHICH CAN BE UP TO 

6000 FEET (1830 METERS) LONG. 


EACH ICS/ICR-11 CAN ACCOMMODATE UP TO 16 FUNCTIONAL I/O MODULES. 
RSX-11M/S SUPPORTS ANY MIXTURE OF ICS~11 AND ICR-11 SUBSYSTEMS 
TO A MAXIMUM OF 12. 


HOW MANY ICS/ICR-11 SUBSYSTEMS DO YOU HAVE? [D R:0.-12.]: 


THE RSX-11M/S ICS/ICR-11 DRIVER PROVIDES THE CAPABILITY TO 
INITIATE A TASK AS THE RESULT OF AN UNSOLICITED (EXTERNAL) 
INTERRUPT. IF THIS OPTION IS SELECTED, SUPPORT IS PROVIDED TO 
ALLOW TASKS TO BE LINKED TO INTERRUPTS AND TO OBTAIN ACTIVATION 
DATA WHEN INITIATED. 


DO YOU WANT TASK ACTIVATION FROM UNSOLICITED INTERRUPTS? [Y/N]: 
234 IS THE STANDARD VECTOR ADDRESS FOR THE FIRST ICS/ICR-1l. 
ADDITIONAL VECTORS ARE ASSIGNED FROM THE FLOATING VECTOR SPACE 


STARTING AT 300. CONSULT FIELD SERVICE TO DETERMINE LOCATIONS 
IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT ICS/ICR-11 [0 R:234-774 D:234]: 
171776 IS THE STANDARD CSR ADDRESS FOR THE FIRST ICS/ICR-11l. 
ADDITIONAL ICS/ICR-11 CSR ADDRESSES ARE ASSIGNED STARTING AT 
171766 AND PROCEED DOWNWARD AT EIGHT BYTE INTERVALS (E.G. 
171766, 171756, 171746, ETC.). 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:171776]: 


Note that the default CSR address is decremented as 
described above. 


IS IT AN ICR-11? [Y/N]: 


=e "=e 67S 


me “ee "6 “EO 


+ 


ue ™ SO 


~=s ™~e TO 


=e =e WO 


SYSGEN DIALOGUE DETAILS 


This query is repeated for each ICS/ICR-11l selected. 


THE IAD~-IA IS A MERCURY WETTED FLYING CAPACITOR ANALOG TO 
DIGITAL CONVERTER WITH 8 CHANNELS OF WIDE RANGE DIFFERENTIAL 
INPUT. 


HOW MANY A/D CONVERTER MODULES IN THIS ICS/ICR? [D R:0.-16.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If answered with a non-zero value, 
the next two questions are asked. 


WHAT IS THE MODULE NUMBER OF THE NEXT A/D CONVERTER? [D R:0.-15.]: 


THE IMX-IA IS A 16 CHANNEL EXPANDER MULTIPLEXER FOR THE IAD-IA 
A/D CONVERTER. UP TO 7 IMX-IA MODULES MAY BE ADDED TO EACH 
IAD-IA A/D CONVERTER. ALL IMX-IA MODULES MUST BE PHYSICALLY 
ADJACENT TO THEIR ASSOCIATED IAD-IA CONVERTER. 


HOW MANY EXPANSION MULTIPLEXERS DOES IT HAVE? [D R:0.-7.]: 


This query is repeated as many times as the number of A/D 
converters specified. Note that the queries for module 
number and number of multiplexers occur one after the other 
for each A/D converter. The repeat sequence repeats both 
queries. 


THE IDA-OA IS A 4 CHANNEL DIGITAL TO ANALOG CONVERTER CAPABLE 
OF DRIVING 0 TO 10 VOLTS OR O TO 50 MILLIAMPS. 


HOW MANY D/A CONVERTER MODULES IN THIS ICS/ICR? [D R:0.-16.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If this query is answered with a 
nonzero value, then the next question is asked. 


Note that in the next six queries, the number of module 
types is 16 minus the number of modules’. previously 
specified. 


ENTER THE MODULE NUMBER OF THE NEXT D/A CONVERTER [D R:0.-15.]: 


This query is repeated as many times as the number of D/A 
converters specified. 


THE SINGLE-SHOT OUTPUTS AVAILABLE FOR THE ICS/ICR-11 INCLUDE 
THE IDC~OB DC VOLTAGE OUTPUT AND THE IAC-OB AC VOLTAGE OUTPUT 
MODULES. 


HOW MANY SINGLE-SHOT OUTPUT MODULES IN THIS ICS/ICR? [D R:0.-x.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If this query is answered with a 
nonzero value, then the next question is asked. 


ENTER MODULE NUMBER OF THE NEXT SINGLE-SHOT OUTPUT [D R:0.-15.]: 


This query is repeated as many times as the number of 
single-shot output modules specified. 


THE BI-STABLE DIGITAL OUTPUT MODULES FOR THE ICS/ICR-11 INCLUDE 
THE IRL-OA AND IRL-OB RELAY OUTPUTS, AND THE IAC-OA AC VOLTAGE 
OUTPUTS. 
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HOW MANY BI-STABLE OUTPUT MODULES IN THIS ICS/ICR? [D R:0.-x.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If this query is answered with a 
nonzero value, then the next question is asked. 


ENTER MODULE NUMBER OF THE NEXT BI-STABLE OUTPUT [D R:0.-15.]: 


This query is repeated for each bi-stable output module 
specified. 


THE DIGITAL SENSE MODULES FOR THE ICS/ICR-11 INCLUDE THE IDC-IA 
ISOLATED DC INPUT, THE IDC-ID NON-ISOLATED INPUT, AND THE 
IAC-IA AC INPUT. 


HOW MANY DIGITAL SENSE MODULES IN THIS ICS/ICR? [D R:0.-x.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If this query is answered with a 
nonzero value, then the next question is asked. 


ENTER MODULE NUMBER OF THE NEXT DIGITAL SENSE [D R:0.-15.]: 


This query is repeated for each digital sense module 
specified. 


THE DIGITAL INTERRUPT MODULES FOR THE ICS/ICR-11 INCLUDE THE 
IDC-IB ISOLATED DC INTERRUPT, THE IDC-IE NON-ISOLATED DC 
INTERRUPT, AND THE IAC-IB AC INTERRUPT. 


HOW MANY DIGITAL INTERRUPT MODULES IN THIS ICS/ICR? [D R:0.-x.]: 


This query appears as many times as_ the number of 
ICS/ICR-lls specified. If this query is answered with a 
nonzero value, then the next question is asked. 


ENTER MODULE NUMBER OF THE NEXT DIGITAL INTERRUPT ]D R:0.-15.]: 


This query is repeated for each digital interrupt module 
specified. 


THE IDC-IC IS A 16 BIT BINARY UP-COUNTER WITH PRESCALAR INPUT 
AND BOTH EXTERNAL TRIGGER AND OVERFLOW OUTPUTS. 


HOW MANY I/O COUNTER MODULES IN THIS ICS/ICR? [D R:0.-x.]: 


This query appears as many times as the number of 
ICS/ICR-lls specified. Note that the queries for interrupt 
vector, CSR, and ICS/ICR~-l1l and the key queries for A/D 
converters, D/A converters, single-shot outputs, bistable 
outputs, digital sense, digital interrupt, and I/O counters 
occur one after the other for each ICS/ICR-ll. The repeat 
sequence repeats all ten queries. If the answer to this 
query is nonzero, then the next question is asked. 


ENTER MODULE NUMBER OR THE NEXT I/O COUNTER [D R:0.-15.]: 


This query is repeated for each I/0 counter module 
specified. 


THE RSX-11M/S ICS/ICR-11 DRIVER WILL OPTIONALLY RESTORE THE 
STATE OF ALL BI~STABLE DIGITAL OUTPUTS, ANALOG OUTPUTS, AND I/O 
PRESCALAR VALUES ON POWER RECOVERY AND RECOVERY FROM SUSTAINED 
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ICR-11 SERIAL TRANSMISSION ERRORS. 
RESTORE MODULE STATUS ON POWER AND ERROR RECOVERY? [Y/N]: 


The above query is asked only if the target system contains 
a bistable output, D/A converter, or I/O counter modules. 


THE RSX-11M/S ICS/ICR-1l1 DRIVER WILL PLACE AN ICR-11 SUBSYSTEM 
OFFLINE IF THE SERIAL LINE ERRORS EXCEED A PREDEFINED LIMIT 
DURING ONE SECOND OF ELAPSED TIME. THE SUBSYSTEM WILL 
AUTOMATICALLY BE PLACED ONLINE WHEN SERIAL LINE ERRORS HAVE 
STOPPED. 


HOW MANY LINE ERRORS ARE ACCEPTABLE PER SEC.? [D R:0.-5000.]: 


The above query is asked only if the target system contains 
an ICR-1l subsystem. 


THE DRS-1l1l IS A DIGITAL I/O MODULE DESIGNED TO MEET THE NEEDS 
OF SMALL INDUSTRIAL DATA ACQUISITION AND CONTROL SYSTEMS. 
EACH DRS-11 MODULE PROVIDES 48 BUFFERED DIGITAL OUTPUTS AND 
ONE RC FILTERED INTERRUPT INPUT. 


HOW MANY DRS-11 DIGITAL OUTPUT MODULES DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT MODULE STATUS RESTORED ON POWER RECOVERY? [Y/N]: 
ENTER CSR ADDRESS OF THE FIRST DRS-11 [0 R:160000-177700]: 


WHAT IS THE VECTOR ADDRESS OF THE NEXT DRS-11? [O R:300~-774]: 


Note that since the DRS/DSS-1l driver cannot be loadable, 
the loadable driver query was omitted. 


The power recovery and CSR address questions are asked only 
once. The vector address question is asked for each DRS-1ll 
specified. 


THE DSS-1l1 IS A DIGITAL I/O MODULE DESIGNED TO MEET THE NEEDS 
OF SMALL INDUSTRIAL DATA ACQUISITION AND CONTROL SYSTEMS. 

EACH DSS-11 MODULE PROVIDES 49 OPTICALLY ISOLATED INPUTS 
CONSISTING OF 48 NON-BUFFERED SENSE DATA INPUTS AND 1 INTERRUPT 
INPUT. 


HOW MANY DSS-11 DIGITAL INPUT MODULES DO YOU HAVE? [D R:0.~-x.]: 


Note that x above is replaced by 16 minus the number of 
DRS-lls specified. 


The combined number of DRS-1ll and DSS-1l modules’ cannot 
exceed 16. Therefore, if 16 DRS-11l modules were specified, 
the above DSS-1l query and the next two pertaining to the 
CSR and vector addresses of the DSS-11l module are omitted. 


ENTER CSR ADDRESS OF THE FIRST DSS-11 [0 R:160000-177700]: 
WHAT IS THE VECTOR ADDRESS OF THE NEXT DSS-11? [O R:300-774]: 


THE RSX-11M/S DRS/DSS-11 DRIVER PROVIDES THE CAPABILITY TO 
INITIATE A TASK AS THE RESULT OF AN UNSOLICITED (EXTERNAL) 
INTERRUPT. IF THIS OPTION IS SELECTED, SUPPORT IS PROVIDED TO 
ALLOW TASKS TO BE LINKED TO INTERRUPTS AND TO OBTAIN ACTIVATION 
DATA WHEN INITIATED. 


DO YOU WANT TASK ACTIVATION FROM UNSOLICITED INTERRUPTS? [Y/N]: 
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This question is asked if at least one DRS/DSS-11l module was 
specified. 


The following queries concerning the UDC1l digital 
controllers are asked only if ICS/ICR support was omitted. 


THE UDC1l1 IS AN INPUT/OUTPUT OPTION FOR INDUSTRIAL AND PROCESS 
CONTROL APPLICATIONS THAT USE THE PDP-11l COMPUTER. THE UDC11l 
INTERROGATES OR DRIVES UP TO 252 DIRECTLY ADDRESSABLE DIGITAL 
SENSE AND CONTROL FUNCTIONAL I/O MODULES OR UP TO 4032 
INDIVIDUAL DIGITAL POINTS. 


RSX-11M/S SUPPORTS. ONLY ONE UDC CONTROLLER. THE ONLY VALID 
ANSWERS TO THIS QUERY ARE 0 AND l. 


HOW MANY UDC11 CONTROLLERS DO YOU HAVE? [D R:0.-l.]: 

234 IS THE STANDARD VECTOR ADDRESS FOR THE UDCll. 

WHAT IS THE VECTOR ADDRESS OF THE UDC11? [O R:60-774 D:234]: 
171776 IS THE STANDARD CSR ADDRESS FOR THE UDC11. 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:171776]: 


The UDCll can support up to 252 modules, which can be 
classified into seven types: 


1. Analog input 

2. Analog output 

3. Digital interrupt 
4. Digital sense 

5. Bistable output 

6. Single~-shot output 
7. I/O counters 


RSX-11M/RSX-11S requires that modules of the same type 
occupy consecutive locations within the UDCl1l. Thus, if 
there are seven analog input modules and the first module 
starts at slot 0, then the last must be at. slot 6. 
Obviously, module types cannot overlap, though unassigned 
slots are permitted. 


The queries which follow establish the module boundaries. 


HOW MANY ADUO1 ANALOG INPUT MODULES DO YOU HAVE? [D R:0.-252.]: 
ENTER MOD. NUMBER OF THE FIRST ADUO1 ANALOG INPUT [D R:0.-252.]: 


The next query appears only if the number of ADUO1 analog 
input modules was zero. 


HOW MANY IAD-IA ANALOG INPUT MODULES DO YOU HAVE? [D R:0.-252.]: 
ENTER MOD. NUMBER OF THE FIRST IAD-IA ANALOG INPUT [D R:0.-252.]: 


Note that in the following queries, x is replaced by 252 
Minus the number of other modules specified. 


HOW MANY ANALOG OUTPUT MODULES DO YOU HAVE? [D R:0.-x.]: 

ENTER MOD. NUMBER OF THE FIRST ANALOG OUTPUT [D R:0.-252.]: 

HOW MANY DIGITAL INTERRUPT MODULES DO YOU HAVE? [D R:0.-x.]: 
ENTER MOD. NUMBER OF THE FIRST DIGITAL INTERRUPT [D R:0.-252.]: 
HOW MANY DIGITAL SENSE MODULES DO YOU HAVE? [D R:0.-x.]: 

ENTER MOD. NUMBER OF THE FIRST DIGITAL SENSE [D R:0.-252.]: 

HOW MANY BI-STABLE OUTPUT MODULES DO YOU HAVE? [D R:0.-x.]: 
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ENTER MOD. NUMBER OF THE FIRST BI-STABLE OUTPUT [D R:0.-252.]: 
HOW MANY SINGLE-SHOT OUTPUT MODULES DO YOU HAVE? [D R:0.-x.]: 
ENTER MOD. NUMBER OF THE FIRST SINGLE-SHOT OUTPUT [D R:0.-252.]: 
HOW MANY I/O COUNTER MODULES DO YOU HAVE? [D R:0.-x.]: 

ENTER MOD. NUMBER OF THE FIRST I/O COUNTER [D R:0.-252.]: 


This is the end of process I/O peripheral queries. 
**ALL SYSTEMS ** 

THE CR11 CARD READER READS EIA STANDARD 80-COLUMN PUNCHED DATA 
CARDS AT 300 CARDS PER MINUTE; THE CM11-F READS 80-COLUMN 
MARK-SENSE CARDS, WHICH CAN HAVE PUNCHED HOLES, AT 285 CARDS 
PER MINUTE. 
HOW MANY CM/CR11 CARD READERS DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
enter VECTOR ADDRESS OF THE NEXT CM/CR11? [o r:60-774 d:230]: 
WHAT IS ITS CSR ADDRESS? [o r:160000-177700 d:1777160]: 


YOU MAY OPTIONALLY SPECIFY THE TIME BETWEEN READER NOT READY 
MESSAGES. A RESPONSE OF ZERO SUPPRESSES THE MESSAGES ENTIRELY. 


ENTER INTERVAL FOR READER NOT READY MESSAGES [D R:0.-255. D:15.]: 


Reader not ready messages are displayed in intervals 
1-255 seconds each on the console terminal. 


THE TA11 MAGNETIC TAPE CASSETTE SYSTEM IS DUAL-DRIVE, 
REEL-TO~REEL UNIT DESIGNED TO REPLACE PAPER TAPE. ITS TWO 
DRIVES RUN NON-SIMULTANEOUSLY USING PROPRIETARY DIGITAL 
EQUIPMENT CORPORATION PHILIPS-TYPE CASSETTES. THE TA11 
INCLUDES A CONTROL UNIT AND A DUAL TAPE TRANSPORT. 


HOW MANY TAl11 DUAL CASSETTES DO YOU HAVE? [D R:0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

WHAT IS THE VECTOR ADDRESS OF THE NEXT TA11 [O R:60~774 D:260]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177500]: 

THE RJ/RWP04-05-06 ARE 19 DATA SURFACE, REMOVABLE, RANDOM ACCESS 
BULK STORAGE SYSTEMS WITH A STORAGE CAPACITY OF 43,980,288 WORDS 
(RPO04-05) AND 87,211,520 WORDS (RP06) PER PACK. EACH INCLUDES 


A CONTROL UNIT AND THE FIRST DISK PACK DRIVE AND IS EXPANDABLE 
UP TO EIGHT DRIVES. 


HOW MANY RJ/RWP04-05-06 DISK CONTROLLERS HAVE YOU? [D R:0.-16.]: 


OFFSET RECOVERY IS A TECHNIQUE FOR READING DATA IN INSTANCES 
WHERE IT CANNOT OTHERWISE BE RECOVERED. IT INVOLVES MOVING THE 
DISK READ HEAD IN SMALL INCREMENTS ABOUT CYLINDER CENTERLINE IN 
AN ATTEMPT TO PICK UP A STRONGER SIGNAL AND THUS ALLOW DATA TO 
BE RECOVERED. 


DO YOU WANT OFFSET RECOVERY SUPPORT? [Y/N]: 


of 


Offset recovery is especially important in environments 
where disk packs are frequently moved from drive to drive. 
It is also recommended when a high degree of data 


reliability is required. 
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DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RJ/RWP04-05-06? [0 R:60-774 D:254]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:176700]: 

HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 


This query appears aS many times as_ the number of 
controllers specified. 


THE TYPICAL RESPONSE TO THE NEXT QUESTION IS ZERO. A NONZERO 
RESPONSE SHOULD BE ARRIVED AT AFTER CONSULTATION WITH A DEC 
FIELD SERVICE REPRESENTATIVE. 


ENTER PHYSICAL UNIT NUMBER OF THE FIRST DRIVE [O D:0]: 


This query appears as many times as the number of 
controllers specified. Note that the queries for the 
interrupt vector, CSR, the number of drives, and physical 
unit number occur one after the other for each controller. 
The repeat sequence repeats all four of the queries. 


IS THE FIRST DRIVE AN RPO4 OR RPO5? [Y/N]: 
IS THE NEXT DRIVE AN RP04 OR RPO5? [Y/N]: 


RPO5s and RP06s can be mixed on the same controller; 
specify N to indicate an RP06 unit. The second query is 
repeated as many times as the number of drives. previously 
specified. 


THE RF11-A IS A FAST, LOW-COST, RANDOM~-ACCESS BULK-STORAGE 
SYSTEM. AN RF11-A PROVIDES 262,144 17-BIT WORDS (16 DATA BITS 
AND 1 PARITY BIT) OF STORAGE. UP TO EIGHT RS11 DISKS CAN BE 
CONTROLLED BY ONE RF11 CONTROL FOR A TOTAL OF 2,047,102 WORDS 
OF STORAGE. AN RF11-A INCLUDES A CONTROL UNIT AND THE FIRST 
DISK DRIVE. 


HOW MANY RF11 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RF11? [O R:60-774 D:204]: 
WHAT IS ITS CSR ADDRESS? [O R:160000~177700 D 1777460]: 


THE RK11-D CARTRIDGE DISK DRIVE AND CONTROL IS A COMPLETE MASS 
STORAGE SYSTEM FOR LARGE VOLUME, RANDOM ACCESS DATA STORAGE. 
THE SYSTEM INCLUDES A MODULAR MASS STORAGE DEVICE UTILIZING 
REMOVABLE DISK CARTRIDGES AND A COMPLETE, EASY-TO-PROGRAM, 
CONTROL UNIT. A DISK CARTRIDGE HOLDS OVER 1.2 MILLION WORDS. 
THE SYSTEM IS EXPANDABLE UP TO 9.6 MILLION WORDS PER CONTROL (8 
DISKS). AN RK11-D INCLUDES A CONTROL UNIT AND THE FIRST DISK 
DRIVE. OPTIONALLY, THE CONTROLLER CAN SUPPORT UP TO FOUR RKO5F 
FIXED PLATTER DRIVES HAVING TWICE THE CAPACITY OF THE STANDARD 
RKO5 DRIVES. 


HOW MANY RK1I1 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 


DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
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* ENTER VECTOR ADDRESS OF THE NEXT RK11 [O R:60-774 D:220]: 


* WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177404]: 


* ENTER NUMBER OF RKO5F FIXED PLATTERS [0 R:0-4]: 


This query appears as many times as the number of RK11-Ds 
specified. Note that the queries for the interrupt vector, 


CSR, and the number of drives occur one after the other 


each RK11-D controller. The repeat seguence repeats all 
three of the queries. If fewer than 4 RKO5Fs are specified, 
the next two questions are asked; otherwise they are 


omitted. 


* ENTER NUMBER OF RKO5 REMOVABLE PLATTERS [D R:1l.-x.]: 


Note that x above is replaced by eight minus two times 
number of RKOSFs. 


The RK11-D controller can service up to 8 units where 


RKO5F is handled as 2 standard RKO5 units. If the total 


number of units calculated is odd and there is at least 


RKO5SF drive present, the next question is asked; otherwise 


it is omitted. 


* IS THE LAST DRIVE AN RKO5F? [Y/N]: 


=e "=68 TO TO WO 


* 


* 


me se @8 we tO 


* 


=e =e “@ “08 EO 


Since each RKO5SF requires two unit slots and must’ begin 


an even numbered unit, it may be necessary for the query 
section to add one dummy unit to the system. An example 
would be the case in which unit 0 is an RKO5, unit 1 is an 


empty slot, and units 2 and 3 are an éRKOSF. In 


instance, an affirmative answer (Y) should be supplied, so 
that the query section could supply the required fourth unit 


control block. 


THE RL11/RLO1 DISK SUBSYSTEM USES A MEDIUM PERFORMANCE, DIRECT 
ACCESS DRIVE WITH A SINGLE READ/WRITE HEAD PER SURFACE. EACH 
DRIVE PROVIDES 2,621,440 16-BIT WORDS OF STORAGE ON A REMOVABLE, 
TOP LOADING CARTRIDGE. THE SUBSYSTEM IS EXPANDABLE UP TO FOUR 
DRIVES. 


HOW MANY RL11 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RL11 [0 R:60-774 D:330]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:174400]: 

HOW MANY DRIVES DOES IT HAVE? [D R:1.-4.]: 

THE RK611/RK06-07 IS A 3 DATA SURFACE, REMOVABLE, RANDOM ACCESS 
BULK STORAGE SYSTEM WITH A STORAGE CAPACITY OF 6,944,256 (RK06) 
OR 13,770,240 (RKO7) 16-BIT WORDS PER PACK. THE RK611/RK06-07 
INCLUDES A CONTROL UNIT AND THE FIRST DISK PACK DRIVE. THE 
SYSTEM IS EXPANDABLE UP TO EIGHT DRIVES. 

HOW MANY RK611 DISK CONTROLLERS DO YOU HAVE? [D R:0-16.]: 
OFFSET RECOVERY IS A TECHNIQUE FOR READING DATA IN INSTANCES 
WHERE IT CANNOT OTHERWISE BE RECOVERED. IT INVOLVES MOVING THE 


DISK READ HEAD IN SMALL INCREMENTS ABOUT CYLINDER CENTERLINE IN 


AN ATTEMPT TO PICK UP A STRONGER SIGNAL AND THUS ALLOW DATA TO 
BE RECOVERED. 
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DO YOU WANT OFFSET RECOVERY SUPPORT? [Y/N]: 


Offset recovery is 


especially 


important in 


environments 


where disk packs are frequently moved from drive to drive. 
It is also recommended where a higher degree of data 
reliability is required. 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RK611 [0 R:60-774 D:210]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177440]: 

HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 
This query appears aS many times as the number of RK6l1 
controllers specified. Note that the queries for’ the 


interrupt vector, command register, and the number of drives 


occur one after 
repeat sequence repeats 


the other for each RK611 controller. 


all three of the queries. 


IS THE FIRST DRIVE AN RKO06? [Y/N]: 


IS THE NEXT DRIVE AN RK06? [Y/N 


THE RP11-C/E IS A COMPLETE MASS 
DISK PACK WITH 20 DATA SURFACES 
THE RP11-C/E INCLUDES A CONTROL 


]: 


STORAGE SYSTEM USING A MAGNETIC 
AND A MOVING READ/WRITE HEAD. 
UNIT AND THE FIRST DISK PACK 
EACH HAVING A 


The 


DRIVE. THE SYSTEM IS EXPANDABLE UP TO 8 DRIVES, 
CAPACITY OF 20,480,000 (RPO3) OR 10,240,000 (RPRO2) 16-BIT 
WORDS. ACCESS TIMES ARE 29 MSEC. AVERAGE LATERAL (CYLINDER TO 
CYLINDER) AND 12.5 MSEC. HALF ROTATIONAL. 
HOW MANY RP11-C/E DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
ENTER VECTOR ADDRESS OF THE NEXT RPLIC/E? [O R:60-774 D:254]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:176714]: 
HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 
This query appears aS many times as the number 
controllers specified. Note that the queries 
interrupt vector, CSR, and the number of drives, 


after the other for each RP11C/E controller. 
sequence repeats all three of the queries. 


[Y/N]: 
IS THE NEXT DRIVE AN RPRO2? [Y/N]: 


of RPI1I1C/E 

for the 
occur one 
The repeat 


IS THE FIRST DRIVE AN RPRO02? 


This query is repeated as many times as the number of drives 
previously specified. 


THE RWM03 IS A REMOVABLE PACK, RANDOM ACCESS DISK STORAGE 
SYSTEM WITH A STORAGE CAPACITY OF 33,710,080 WORDS PER PACK. 
EACH INCLUDES A CONTROL UNIT AND THE FIRST DISK PACK DRIVE AND 
IS EXPANDABLE TO EIGHT DRIVES. 
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HOW MANY RWMO3 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 


OFFSET RECOVERY IS A TECHNIQUE FOR READING DATA IN INSTANCES 
WHERE IT CANNOT OTHERWISE BE RECOVERED. IT INVOLVES MOVING THE 
DISK HEAD ON EITHER SIDE OF THE CYLINDER CENTERLINE IN AN 
ATTEMPT TO PICK UP A STRONGER SIGNAL AND THUS ALLOW DATA TO BE 
RECOVERED. 


DO YOU WANT OFFSET RECOVERY SUPPORT? [Y/N]: 
Offset recovery is especially important in environments 
where disk packs are frequently moved from drive to drive. 
It is also recommended where a higher degree of data 
reliability is required. 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RWMO3 [O R:60:774 D:254]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:176700]: 

HOW MANY DRIVES DOES IT HAVE? [D R:1.~-8.]: 
This query is repeated as many times as the number of RWM03 
controllers specified. Note that the queries for the 
interrupt vector, CSR, and the number of drives, occur one 
after the other for each RWMO3 controller. The repeat 
sequence repeats all three of the queries. 

THE TYPICAL RESPONSE TO THE NEXT QUESTION IS ZERO. A NONZERO 

RESPONSE SHOULD BE ARRIVED AT AFTER CONSULTATION WITH A DEC 

FIELD SERVICE REPRESENTATIVE. 

ENTER PHYSICAL UNIT NUMBER OF THE FIRST DRIVE [0 D:0]: 

THE RJ/RWS03-04 USES THE RH11 CONTROLLER. THE RJ/RWS03 HAS A 

CAPACITY OF 256K WORDS; THE RJ/RWS04 HAS A CAPACITY OF 512K 

WORDS. TRANSFER RATE IS 4-MICROSECONDS PER WORD WITH AN 

AVERAGE LATENCY OF 8-MILLISECONDS. 

HOW MANY RJ/RWS03-04 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RJ/RWS03-04 [O R:60-774 D:204]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172040): 

HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 


This query appears as many times as_ the number of 
RJ/RWS03-04 controllers specified. 


THE TYPICAL RESPONSE TO THE NEXT QUESTION IS ZERO; A NON-ZERO 
RESPONSE SHOULD BE ARRIVED AT AFTER CONSULTATION WITH A DEC 
FIELD SERVICE REPRESENTATIVE. 


ENTER PHYSICAL UNIT NUMBER OF THE FIRST DRIVE [O D:0]: 
This query is repeated as many times as the number of 


RJ/RWS03-04 controllers specified. Note that the queries 
for the interrupt vector, CSR, number of drives, and _ the 
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unit number of first drive occur one after the other for 
each RJ/RWS03-04 controller. The repeat sequence repeats 
all four of the queries. 


IS THE FIRST DRIVE AN RSO3? [Y/N]: 
IS THE NEXT DRIVE AN RSO3? [Y/N]: 


RSO3s and RS0O4s can be mixed on the same controller; 
specify N to indicate an RSO4 unit. This query is repeated 
as many times as the number of drives previously specified. 


THE TC11-G IS A DUAL-UNIT BIDIRECTIONAL MAGNETIC-TAPE TRANSPORT 
SYSTEM FOR AUXILIARY DATA STORAGE. 


THE SYSTEM STORES INFORMATION AT FIXED POSITIONS ON MAGNETIC 
TAPE AS IN MAGNETIC DISK OR DRUM STORAGE DEVICES, RATHER THAN 
AT UNKNOWN OR VARIABLE POSITIONS AS IN CONVENTIONAL MAGNETIC 
TAPE SYSTEMS. 


A DECTAPE SYSTEM CONSISTS OF UP TO 4 DUAL TRANSPORTS, AND A 
CONTROL UNIT (WHICH WILL BUFFER AND CONTROL INFORMATION FOR UP 


TO FOUR DUAL TRANSPORTS). A TC11-G INCLUDES A CONTROL UNIT AND 
THE FIRST DUAL TAPE TRANSPORT. 


HOW MANY TCl1l DECTAPE CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT TC11? [O R:60-774 D:214]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177342]: 

HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 
This query appears aS many times as the number of fTC1l1-G 
controllers specified. Note that the queries for the 
interrupt vector, command register, and the number of drives 
occur one after the other for each TCll controller. The 
repeat sequence repeats all three of the queries. 

THE RX11 IS AN INDUSTRY-COMPATIBLE DISK STORAGE SYSTEM FOR 

FLEXIBLE (FLOPPY) DISKS. AN RX1l1 IS CAPABLE OF CONTROLLING TWO 

FLEXIBLE DISK DRIVES EACH HAVING A CAPACITY OF 128,128 16-BIT 

WORDS. 

HOW MANY RX11 DISK CONTROLLERS DO YOU HAVE? [D R:0.-16.]: 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT RX11? [O R:60-774 D:264]: 

WHAT IS ITS CSR ADDRESS? [0 R:160000-177700 D:177170]: 

HOW MANY DRIVES DOES IT HAVE? [O R:1-2]: 
This query appears as many times as the number of RXl1l 
controllers specified. Note that the queries for the 
interrupt vector, CSR, and the number of drives occur one 


after the other for each RX1l controller. The repeat 
sequence repeats all three of the queries. 
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If the target system is a PDP-11/70 with extended memory 
Support, then the next five questions are omitted. Note 
also that the VT11/VS60 driver cannot be loadable. 


THE VT11 IS A LOW COST, LINE DRAWING, GRAPHICS DISPLAY 
SUBSYSTEM, WHICH MAY BE PACKAGED IN THE GT SERIES OF DISPLAY 
SYSTEMS OR RUN SEPARATELY. VT11 SUPPORT IN RSX-11M HAS THE . 
FOLLOWING RESTRICTIONS: 


ONLY ONE VT11 (OR VS60) IN THE SYSTEM, 

THE DRIVER DOES NOT OPERATE ON THE PDP-11/70 IN 22-BIT MODE, 
THE DISPLAY BUFFER OF THE TASK DRIVING THE VT11 MUST RESIDE 
COMPLETSLY IN THE LOW 28K OF SYSTEM MEMORY. 


DO YOU HAVE A VT11l GRAPHICS DISPLAY SUBSYSTEM? [Y/N]: 


An affirmative reply to this guery will exclude the high 
performance VS60 graphics display subsystem from your 
configuration. Hence a Y response to VT1l1 will inhibit the 
display of queries concerning the VS60. 


THE VECTOR ADDRESS FOR THE GRAPHICS DISPLAY SUBSYSTEMS IS 
ASSIGNED FROM THE FLOATING VECTOR SPACE STARTING AT 300. 
CONSULT FIELD SERVICE TO DETERMINE THE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE GRAPHICS SUBSYSTEM [O R:300-774]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172000]: 


The following queries concerning the VS60 graphics display 
subsystem are displayed only if VT11l support was not 
selected. 


THE VS60 IS A HIGH PERFORMANCE, LINE DRAWING, GRAPHICS DISPLAY 
SUBSYSTEM. THE VS60 IS SUPPORTED IN RSX-11M WITH THE FOLLOWING 
RESTRICTIONS: 


- THE DRIVER DOES NOT OPERATE ON THE PDP-11/70 IN 22-BIT MODE, 
~ ONLY ONE VS60 (OR VT11) IN THE SYSTEM. 


DO YOU HAVE A VS60 GRAPHICS DISPLAY SUBSYSTEM? [Y/N]: 
the vs60 can drive two crt monitors independently. 
DOES IT DRIVE TWO CRT MONITORS? [Y/N]: 


This guery determines whether or not such functionality is 
desired. 


ENTER VECTOR ADDRESS OF THE GRAPHICS SUBSYSTEM [O R:300-774]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172000]: 
THE LP1l HIGH SPEED LINE PRINTER IS AVAILABLE IN EIGHT MODELS. 


LP11-F 80 COLUMN, 64 CHARACTER 

LP11-H 80 COLUMN, 96 CHARACTER 

LP1l1l-J 132 COLUMN, 64 CHARACTER 

LP11-K 132 COLUMN, 96 CHARACTER 

LP11-R 132 COLUMN, 64 CHARACTER (HEAVY DUTY, HIGH SPEED) 
LP1lI=-s 132 COLUMN, 96 CHARACTER (HEAVY DUTY, HIGH SPEED) 
LP1l1-V 132 COLUMN, 64 CHARACTER 

LP11-W 132 COLUMN, 96 CHARACTER 
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THE LS1l LINE PRINTER IS A MEDIUM-SPEED IMPACT DOT~MATRIX LINE 


PRINTER FOR THE PDP-11 FAMILY. THE LINE PRINTER PRINTS AT A 
RATE OF 165 CHARACTERS PER SECOND AT 10 CHARACTERS PER INCH 
WITH UP TO 132 CHARACTERS PER LINE. 

THE LA180 LINE PRINTER IS A DEC MANUFACTURED DEVICE SIMILAR 
THE LS1ll WITH THE EXCEPTION THAT IT PRINTS AT THE RATE OF 18 
CHARACTERS PER SECOND. 


THE LV1l IS A HIGH-SPEED ELECTROSTATIC PRINTER-PLOTTER. ONLY 
THE PRINT OPTION IS SUPPORTED UNDER RSX-11M/S. 


HOW MANY LP/LS/LV11/LA180 LINE PRINTERS DO YOU HAVE? [D R:0- 


TO ENSURE MAXIMUM THROUGHPUT ON THE LP11-R OR LP11-S 
ANSWER YES TO THE NEXT QUESTION. 


DO YOU WANT FAST PRINTER SUPPORT? [Y/N]: 


This option ensures maximum print throughput on the 
or LPil1-S. 


DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

ENTER VECTOR ADDRESS OF THE NEXT LINE PRINTER? [O R:60-774 D 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177514]): 

IS IT AN LS1l1, LA180, OR LP11-V/W? [Y/N]: 


Improper specification of the printer type may cause 
failures. 


This query is repeated for each printer specified. 
IS IT A 132. COLUMN PRINTER? [Y/N]: 


Improper specification of line width will cause 
truncation. An N or null response defaults to 80 co 


TO 
0 


16): 


LP11-R 


2200]: 


output 


buffer 
lumns. 


This query appears aS many times as the number of printers 


specified. Note that the queries for the interrupt 
CSR, LS1l, and line width occur one after the other 
printer specified. The repeat sequence repeats all 
the queries. 


After the repeat sequence completes, the following i 


vector, 
for each 
four of 


s asked. 


YOU MAY OPTIONALLY SPECIFY THE NUMBER OF SECONDS BETWEEN PRINTER 
NOT READY MESSAGES. AN INTERVAL OF ZERO SUPPRESSES THE MESSAGES 
ALTOGETHER. THE DEFAULT IS 15. SECONDS. FOR THE MINIMUM SYSTEM 


YOU MUST ANSWER THE NEXT QUESTION YES. 

DO YOU WANT 15. SECONDS BETWEEN PRINTER NOT READY MESSAGES? 
If not, you are asked to specify the interval in 
that the message will be displayed. Printer not 
displayed on the console terminal. 

HOW MANY SECONDS BETWEEN NOT READY MESSAGES [D R:0.-255. D:l 

THE TJ/TWU/TWE16-45 IS A MAGNETIC TAPE SYSTEM IDEALLY SUITED 


WRITING, READING, AND STORING LARGE VOLUMES OF DATA AND 
PROGRAMS IN A SERIAL MANNER. THE 10 1/2-INCH TAPE REELS 


[Y/N]: 
seconds 
ready is 
5] 4 


FOR 
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CONTAIN UP TO 2400 FEET OF TAPE. THE TAPE IS 9-TRACK, RECORDED 
EITHER NRZI OR PHASE ENCODED WITH RECORDING DENSITIES OF 800 OR 
1600 BPI. 


=e =e ™O 


* HOW MANY TM02/03 MAGTAPE CONTROLLERS HAVE YOU? [O R:0.-16.]: 
* DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


* ENTER VECTOR ADDRESS OF THE NEXT TJ/TWU/TWE16-45? [0 R:60-774 
D: 224]: 


* WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172 440): 
* HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 


This query appears aS many times as the number of 
TJ/TWU16-45 controllers specified. 


THE TYPICAL RESPONSE TO THE NEXT QUESTION IS ZERO; A NON-ZERO 
RESPONSE SHOULD BE ARRIVED AT AFTER CONSULTATION WITH A DEC 
FIELD SERVICE REPRESENTATIVE. 
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* ENTER PHYSICAL UNIT NUMBER OF THE TM02/03 FORMATTER [O D:0]: 


This query appears aS many times as_ the number of 
TJ/TWU16-45s specified. Note that the queries for the 
interrupt vector, CSR, the number of drives, and the 
physical unit number occur one after the other for each 
TJ/TWU16-45. The repeat sequence repeats all four of the 
queries. 


THE TM/TMA/TMB11 IS A MAGNETIC TAPE SYSTEM IDEALLY SUITED FOR 
WRITING, READING, AND STORING LARGE VOLUMES OF DATA AND 
PROGRAMS IN A SERIAL MANNER. THE SYSTEM READS AND WRITES IN 
INDUSTRY-COMPATIBLE FORMAT. TM11/TU/E10 DRIVES SUPPORT 10.5-INCH 
REELS CONTAINING UP TO 2400 FEET OF TAPE UPON WHICH OVER 180 
MILLION BITS OF DATA CAN BE STORED ON HIGH DENSITY 9-TRACK TAPE 
OR OVER 140 MILLION BITS CAN BE STORED ON HIGH DENSITY 7-TRACK 
TAPE. TMA11/TSOQ3 DRIVES SUPPORT 7-INCH REELS CONTAINING UP TO 
600 FEET OF TAPE IN HIGH DENSITY 9-TRACK FORMAT. TMB11/TULOW 
DRIVES ARE COMPATIBLE WITH TU10 DRIVES EXCEPT THEY OPERATE ONLY 
ON 800 BPI, 9-TRACK TAPE. 
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HOW MANY TM/TMA/TMB11 MAGTAPE CONTROLLERS HAVE YOU [D R:0.-16.] 


* 


DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

* ENTER VECTOR ADDRESS OF THE NEXT TM/TMA/TMB11? [O R:60-774 D:224]: 
* WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172522]: 

* HOW MANY DRIVES DOES IT HAVE? [D R:1.-8.]: 


This query appears as many times as_ the number of 
TM/TMA/TMBlis specified. Note that the queries for the 
interrupt vector, command register, and the number of drives 
occur one after the other for each controller. The repeat 
sequence repeats all three of the queries. 


THE PCll IS A HIGH SPEED PAPER TAPE READER/PUNCH THAT IS 
CAPABLE OF READING EIGHT-HOLE UNOILED PERFORATED PAPER TAPE AT 
300 CHARACTERS PER SECOND, AND PUNCHING TAPE AT 50 CHARACTERS 
PER SECOND. 
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HOW MANY PCll PAPER TAPE READER/PUNCHES DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVERS TO BE LOADABLE? [Y/N]: 


The answer to this query determines whether both or neither 
of the two paper tape drivers (PRDRV and PPDRV) are to be 
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loadable. 
ENTER VECTOR ADDRESS OF THE NEXT PC11? [0 R:60-774 D:70]: 
WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177550]: 
THE PR1l IS A HIGH SPEED PAPER TAPE READER THAT IS CAPABLE OF 
READING EIGHT-HOLE UNOILED PERFORATED PAPER TAPE AT 300 
CHARACTERS PER SECOND. 
EXCLUDE THE NUMBER OF PCl1'S, IF ANY, 
FROM THE ANSWER TO THE NEXT QUESTION. 
HOW MANY PR11 PAPER TAPE READERS DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
ENTER VECTOR ADDRESS OF THE NEXT PRI11? [0 R:60-774 D:70]: 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177550]: 


NOTE 


THE OPERATOR CONSOLE MUST BE ATTACHED 
VIA A DLI11. 


THE DL11 SERIES OF ASYNCHRONOUS SINGLE LINE INTERFACES HANDLE 
FULL OR HALF DUPLEX COMMUNICATION BETWEEN A WIDE VARIETY OF 
SERIAL COMMUNICATION CHANNELS AND A PDP-1l11 COMPUTER. 


WITH A DL11 INTERFACE, A PDP-11 COMPUTER CAN COMMUNICATE WITH A 


LOCAL TERMINAL SUCH AS A CONSOLE TELEPRINTER. 
INCLUDE CONSOLE IN THE ANSWER TO 
THE NEXT QUESTION. 


ENTER NUMBER OF DL11 LINE INTERFACES [D R: 1.-8.]: 


For RSX-l1M systems, at least one DL11 must be 


generated in the system; there is no 


requirement for RSX-11S systems. If the answer 
this query is nonzero, then the next three queries 


appear. Otherwise they are not displayed. 


The driver services terminals that are connected to a 
DL11-A/B/C/D/W only. The DL11-E requires a separate 


driver. 
THE TERMINAL DRIVER CAN ONLY BE LOADED BY VMR. 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
60 IS THE STANDARD VECTOR ADDRESS FOR THE FIRST DL11. 
ADDITIONAL VECTORS ARE ASSIGNED FROM THE FLOATING VECTOR SPACE 
STARTING AT 300. CONSULT FIELD SERVICE TO DETERMINE LOCATIONS 
IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DL11 [O R:60-774 D:60]: 
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177560 IS THE STANDARD CSR ADDRESS FOR THE FIRST DL11. 
ADDITIONAL DL11 CSR ADDRESSES ARE ASSIGNED IN THE RANGE 176000 
TO 176770. CONSULT FIELD SERVICE TO DETERMINE LOCATIONS IF 
UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:177560]: 


THE DH11 MULTIPLEXER CONNECTS THE PDP-11l WITH 16 ASYNCHRONOUS 
SERIAL COMMUNICATIONS LINES OPERATING WITH INDIVIDUALLY 
PROGRAMMABLE PARAMETERS. THESE PARAMETERS ARE: 


TRANSMITTER SPEED (BAUD) 
RECEIVER SPEED (BAUD) 


ENTER NUMBER OF DH11 ASYNCHRONOUS LINE MULTIPLEXERS [D R:0.-16.]: 
THE TERMINAL DRIVER CAN ONLY BE LOADED BY VMR. 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


If a DL1l has been included in the system, the loadable 
driver question will be suppressed because these controllers 
are supported by the same driver. 


REMOTE LINES WILL OCCUPY CONSECUTIVE LINE LOCATIONS, AND IF 
MORE THAN 16 REMOTE LINES ARE SPECIFIED THEY MUST ALSO OCCUPY 
CONSECUTIVE DH11'S. ASSIGNMENT OF LINES IS BY GROUPS OF 4. 


Note that in the following question, x is replaced by 16 
times the number of DH11ls specified. 


ENTER TOTAL NUMBER OF DIAL UP LINES [D R:0.-x.]: 


If the reply to this question is zero, the next two queries 
are omitted. If DM11-BB modem support is selected, the 
initial dial-in terminal baud rate must be specified. The 
available baud rates are 110, 150, or 300. The selected 
baud rate applies to all dial-in lines serviced by any 
DM11-BB. 


THE BAUD RATE AT WHICH ALL REMOTE LINES ARE ANSWERED MAY BE SET 
TO 110, 150, OR 300 BAUD. 


DO YOU WANT TO ANSWER AT 110 BAUD? [Y/N]: 
DO YOU WANT TO ANSWER AT 150 BAUD? [Y/N]: 


If both of these queries are answered negatively, the 
initial dial-in baud rate is set to 300. 


LOCAL LINES WILL ALSO OCCUPY CONSECUTIVE LINES AND DH1I1'S. 
THEIR ASSIGNMENT FOLLOWS THE ASSIGNMENT OF ANY REMOTE LINES 
SPECIFIED. 


LOCAL LINES CAN BE EITHER EIA OR 20 MILLIAMP. EACH TYPE MUST 
HAVE AN APPROPRIATE INTERFACE, AND THE INTERFACE SERVICES A 
GROUP OF FOUR LINES OF THE SAME TYPE. THE RESPONSE TO THE 

LOCAL LINE QUERY MAY BE LARGER THAN THE ACTUAL NUMBER OF LOCAL 
LINES, SINCE ALLOCATION IS BY GROUPS OF FOUR. HENCE IF SIX EIA 
LINES ARE INSTALLED, TWO LINE GROUP SLOTS, WHICH CONTAIN EIGHT 
LINES, ARE NEEDED. 


THE REQUIRED RESPONSE TO THE LOCAL LINE QUERY CAN BE CALCULATED 
BY SUMMING THE NUMBER OF EIA AND 20 MILLIAMP LINE GROUPS (EACH 
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LINE GROUP CONTAINS SLOTS FOR FOUR LINES) AND MULTIPLYING BY 
FOUR. 


Note that in the following question, x is replaced by 16 
times the number of DHlls minus the number of dial-up lines. 


ENTER TOTAL NUMBER OF LOCAL LINES [D R:0.-x.]: 


THE VECTOR ADDRESS FOR THE DH11 IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DH11 [O R:300-774]: 


THE CSR ADDRESS FOR THE DH11 IS ASSIGNED FROM THE FLOATING 
ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700]: 


THE VECTOR ADDRESS FOR THE DM11-BB IS ASSIGNED FROM THE 
FLOATING VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE 
TO DETERMINE THE LOCATION IF UNKNOWN. IF A USER HAS SPECIFIED 
THE EXISTENCE OF REMOTE DIAL-UP LINES THE DM11-BB INTERFACE IS 
REQUIRED. ONE DM11-BB CAN SERVICE UP TO 16 REMOTE DIAL-UP 
LINES. 


ENTER VECTOR ADDRESS OF THE NEXT DM11-BB [O R:300-744]: 


If the reply to the query for the number of remote lines was 
nonzero, this query is repeated for each DM11-BB that is 
required. 


WHAT IS ITS CSR ADDRESS? [0 R:16000-177700 D:170500]: 


If the reply to the query for the number of remote lines was 
nonzero, this query iS repeated for each DM11-BB that is 
required. Note that the queries for remote dial-up lines, 
local lines, DH1l interrupt vector, DH11 CSR, DM11-BB 
interrupt vector, and DM11-BB CSR occur one after the other 
for each DHll. The repeat sequence repeats all 6 of the 
queries aS appropriate. 


THE DJ11 IS A MULTIPLEXER INTERFACE BETWEEN 16 ASYNCHRONOUS 
SERIAL DATA-COMMUNICATION CHANNELS AND THE PDP-11l UNIBUS. THE 


DJ11 IS A UNIT WHOSE CHARACTER FORMATS AND OPERATING SPEEDS ARE 
JUMPER OR STRAP SELECTABLE IN GROUPS OF FOUR LINES. 


ENTER NUMBER OF DJ11l ASYNCHRONOUS LINE MULTIPLEXERS [D R:0.-16.]: 

THE TERMINAL DRIVER CAN ONLY BE LOADED BY VMR. 

DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
If a DL11 or DH11 has been included in the system, the 
loadable driver question will be suppressed because these 
controllers are supported by the same driver. 

THE VECTOR ADDRESS FOR THE DJ1ll IS ASSIGNED FROM THE FLOATING 

VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 

DETERMINE THE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DJ1l [O R:300-774]: 
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If the reply to the query for the number of DJlls_ was 
nonzero, this query is repeated for each DJll. 


THE CSR ADDRESS FOR THE DJ11l IS ASSIGNED FROM THE FLOATING 
ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R: 160010-177700]: 
HOW MANY LINES DOES IT HAVE? [D R:1.-16.]: 


This query appears aS many times as the number of DJlls 
specified. Note that the queries for the interrupt vector, 
CSR, and the number of lines occur one after the other for 
each DJll. The repeat sequence repeats all three of the 
queries. 


THE DZ11 MULTIPLEXER CONNECTS THE PDP-11 WITH 8 ASYNCHRONOUS 
SERIAL COMMUNICATIONS LINES OPERATING WITH INDIVIDUALLY 
PROGRAMMABLE PARAMETERS. THESE PARAMETERS ARE: 


TRANSMITTER SPEED (BAUD) 

RECEIVER SPEED (BAUD) 

THE DZ11-E MULTIPLEXER SHOULD BE TREATED AS TWO DZ11''S. THUS IF 
YOU HAVE 1 DZ11-E ANSWER THE NEXT QUESTION WITH 2. 


ENTER NUMBER OF DZ11 ASYNCHRONOUS MULTIPLEXERS [D R:0.-16.]: 
THE TERMINAL DRIVER CAN ONLY BE LOADED BY VMR. 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


If a DL11, DH11, or DJll has been included in the system, 
the loadable driver question will be suppressed because 
these controllers are supported by the Same driver. 


THE DZ1l1 HAS THE ABILITY TO MAINTAIN A FULL DUPLEX CONNECTION 
THROUGH A BELL 103A TYPE MODEM. MODEM SUPPORT REQUIRES ADDED 
CODE IN THE TERMINAL DATA BASE AS WELL AS IN THE DRIVER, AND 
@NCVEASES SYSTEMIOVERHEAD. AS A RESULT, IT SHOULD BE SELECTED 
ONLY IF NEEDED. 


DO ANY OF THE LINES REQUIRE MODEM SUPPORT? [Y/N]: 


If the reply to this question is negative, the next two 
questions are omitted. If modem support is selected, the 
initial dial-in terminal baud rate must be specified. The 
available baud rates are 110, 150, or 300. The selected 
baud rate applies to all dial-in lines serviced by any DZ1l. 


THE BAUD RATE AT WHICH ALL REMOTE LINES ARE ANSWERED MAY BE SET 
TO 110, 150, OR 300 BAUD. 


DO YOU WANT TO ANSWER AT 110 BAUD? [Y/N]: 
DO YOU WANT TO ANSWER AT 150 BAUD? [Y/N]: 


If both of these queries are answered negatively, the 
initial dial-in baud rate is set to 300. 


THE VECTOR ADDRESS FOR THE DZ11 IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 
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ENTER VECTOR ADDRESS OF THE NEXT DZ11 [0 R:300-774]: 


THE CSR ADDRESS FOR THE DZ11 IS ASSIGNED FROM THE FLOATING 
ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 


what is its csr address? [o r:160010-177700]: 
HOW MANY LINES DOES IT HAVE? [D R:1.-8.]: 


INTER~PROCESSOR COMMUNICATION DEVICES CONSIST OF THE FOLLOWING: 
- DA11-B HIGH-SPEED PARALLEL UNIBUS LINK 
- DL11-E ASYNCHRONOUS SERIAL LINE INTERFACE 
- DMC11 SYNCHRONOUS SERIAL LINE INTERFACE 
- DP1ll SYNCHRONOUS SERIAL LINE INTERFACE 
- DQl1 HIGH-SPEED SYNCHRONOUS SERIAL LINE INTERFACE 
- DU11l SYNCHRONOUS SERIAL LINE INTERFACE 
- DUP11 SYNCHRONOUS SERIAL LINE INTERFACE 


DO YOU HAVE ANY INTER~PROCESSOR COMMUNICATION DEVICES? [Y/N]: 


If you do, the pertinent queries concerning inter-processor 
communication devices are asked. 


THE DA11-B UNIBUS LINK IS A HIGH-SPEED, HALF-DUPLEX CHANNEL FOR 
CONNECTING TWO PDP-11 COMPUTERS OVER A DISTANCE OF UP TO 100 

FEET (30 METERS). USING THE DIRECT-MEMORY-ACCESS FACILITIES OF 
EACH COMPUTER, IT IS CAPABLE OF TRANSFERING BLOCKS OF DATA AT 
HIGH DATA RATES WITH MINIMAL PROCESSOR OVERHEAD. 

HOW MANY DA11-B PARALLEL LINE INTERFACES DO YOU HAVE [D R:0.-16.]: 


DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 
ENTER VECTOR ADDRESS OF THE NEXT DAI11-B [O R:60-774 D:124]: 


WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:172414]: 

THE DL11-E SERIES OF ASYNCHRONOUS SINGLE LINE INTERFACES HANDLE 
FULL OR HALF DUPLEX COMMUNICATION BETWEEN A WIDE VARIETY OF 
SERIAL COMMUNICATION CHANNELS AND A PDP~11 COMPUTER. 

HOW MANY DL11-E ASYNC. LINE INTERFACES DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

THE VECTOR ADDRESS FOR THE DL11-E IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 

ENTER VECTOR ADDRESS OF THE NEXT DL11-E [0 R:300-774]: 

THE CSR ADDRESS FOR THE DL11-E IS ASSIGNED FROM THE ADDRESS 
SPACE STARTING AT 175610. CONSULT FIELD SERVICE TO DETERMINE 
THE LOCATION IF UNKNOWN. 

WHAT IS ITS CSR ADDRESS? [O R:175610-177700]: 

IS IT A HALF DUPLEX LINE? [Y/N]: 


HOW MANY SYNC CHAR.S ARE REQUIRED IN A SYNC LEADER? [D R:3.-14.]: 


=e =e Se TO 


=e “SH "8 


=e “e 


=e “ee “8 “Oe “Se "OE 


* 


=e =e 6“ 


+ + + 


SYSGEN DIALOGUE DETAILS 


A typical response is 4-6. If the line is to run at _ high 
speeds or the expected system load is to be heavy, then 


specify a greater number of sync characters. 


If the reply to the query for the number of DLI11-Es 


greater than 1, this query is repeated for each DLII1-E. 
Note that the queries for interrupt vector, CSR, half 
duplex, and sync leader occur one after the other for each 


DL11-E. The repeat sequence repeats all four queries. 


THE DMC1l1 IS A FULL-DUPLEX, SERIAL COMMUNICAITONS LINK WHICH 
IMPLEMENTS THE DDCMP LINE PROTOCOL USING A HIGH SPEED 
MICROPROCESSOR. DATA MESSAGES ARE TRANSFERRED WITH MINIMAL 
PROCESOR OVERHEAD USING THE DMA FACILITIES OF THE PDP-1l. 


HOW MANY DMC11 SYNC. LINE INTERFACES DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


THE VECTOR ADDRESS FOR THE DMC11 IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DMC11 [O R:300-774]: 

THE CSR ADDRESS FOR THE DMC11 IS ASSIGNED FROM THE FLOATING 
ADRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R:160010-177700]: 
IS IT A HALF DUPLEX LINE? [Y/N]: 


The vector address, CSR address, and half duplex questions 


are repeated for each DMC1ll specified. 


If the answer to the half duplex question is negative, 
next query is omitted. 


WHEN THE DMC1ll1 IS USED ON A HALF DUPLEX LINE, ONE END OF THE 


LINE MUST BE THE PRIMARY STATION AND THE OTHER END MUST BE THE 
SECONDARY STATION. 


IS IT THE PRIMARY STATION? [Y/N]: 


THE DP1l PROVIDES A DOUBLE-BUFFERED PROGRAM INTERRUPT INTERFACE 
BETWEEN A PDP-11 AN A SERIAL SYNCHRONOUS LINE. 


THE DPll INTERFACE HANDLES A WIDE VARIETY OF TERMINALS AND LINE 
DISCIPLINES (I.E., LINE CONTROL PROCEDURES AND ERROR CONTROL 
TECHNIQUES). A PROGRAMMER CAN VARY SYNC CHARACTER, CHARACTER 
SIZE, AND MODEM CONTROL LEADS. AUTOMATIC SYNC CHARACTER 
STRIPPING AND AUTOMATIC IDLING ARE ALSO PROGRAM SELECTABLE. 

WHILE IDLING, THE DP1l TRANSMITS THE CONTENTS OF THE SYNC BUFFER. 


HOW MANY DP1ll SYNC LINE INTERFACES DO YOU HAVE? [O R:0.-16.]: 


THE VECTOR ADDRESS FOR THE DP1ll IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DP1l1 [O R:300-774]: 

WHAT IS ITS CSR ADDRESS? [O R:160000-177700 D:174770]: 

IS IT A HALF DUPLEX LINE? [Y/N]: 

HOW MANY SYNC CHAR.S ARE REQUIRED IN A SYNC LEADER? [D R:3.-14.]: 
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A typical response is 4-6. If the line is to run at 
speeds or the expected system load is to be heavy, 
specify a greater number of sync characters. 


If the reply to the query for the number of DPlls 
greater than 1, this query is repeated for each DP1ll. 


high 
then 


was 
Note 


that the queries for interrupt vector, CSR, half duplex, and 


sync leader occur one after the other for each DPll. 
repeat sequence repeats all four queries. 


THE DQl1 IS A HIGH-SPEED, DOUBLE BUFFERED COMMUNICATIONS DEVICE 
DESIGNED TO INTERFACE THE PDP-11 PROCESSOR TO A SERIAL 
SYNCHRONOUS COMMUNICATION LINE. USING THE DIRECT-MEMORY-ACCESS 
FACILITIES OF THE PDP-ll, IT IS CAPABLE OF TRANSFERING BLOCKS 
OF DATA AT HIGH DATA RATES WITH MINIMAL PROCESSOR OVERHEAD. 


HOW MANY DQ11 SYNC. LINE INTERFACES DO YOU HAVE? [D R: 0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


THE VECTOR ADDRESS FOR THE DQ11 IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DQ11 [O R:300-774]: 


THE CSR ADDRESS FOR THE DQ11 IS ASSIGNED FROM THE FLOATING 
ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 


WHAT IS ITS CSR ADDRESS? [O R:160010-177700]: 

IS IT A HALF DUPLEX LINE? [Y/N]: 

DOES IT HAVE THE ERROR DETECTION EXPANDER UNIT? [Y/N]: 
DOES IT HAVE THE CHARACTER DETECTION EXPANDER UNIT? [Y/N]: 


HOW MANY SYNC CHAR.S ARE REQUIRED IN A SYNC LEADER? [D R:3.-14.]: 


The 


A typical response is 4-6. If the line is to run at _ high 


speeds or the expected system load is to be heavy, 
specify a greater number of sync characters. 


If the reply to the query for the number of DQIIl1s 
greater than 1, this query is repeated for each DQI11. 


then 


was 


Note 


that the queries for interrupt vector, CSR, half duplex, 
error detection, character detection, and sync leader occur 
one after the other for each DQIl. The repeat sequence 


repeats all six queries. 


THE DU11 PROVIDES A DOUBLE-BUFFERED PROGRAM INTERFACE BETWEEN A 
PDP-11 AND A SERIAL SYNCHRONOUS LINE. 


THE DU11 PROVIDES A FLEXIBLE INTERFACE IN THAT THE PROGRAMMER 
CAN SPECIFY THE SYNC AND CHARACTER SIZE. MODEM CONTROL 
CAPABILITY ALLOWS THE USE OF THE DU11 IN SWITCHED OR DEDICATED 
APPLICATIONS. THE INTERFACE PROVIDES STRIP SYNC AND IDLE SYNC 
FEATURES TO SIMPLIFY PROGRAMMING AND REMOVE PROCESSOR OVERHEAD. 


HOW MANY DU11 SYNC. LINE INTERFACES DO YOU HAVE? [D R:0.-16.]: 
DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 

THE VECTOR ADDRESS FOR THE DU11 IS ASSIGNED FROM THE FLOATING 
VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
DETERMINE THE LOCATION IF UNKNOWN. 


ENTER VECTOR ADDRESS OF THE NEXT DUI11 [O R:300-774]: 
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THE CSR ADDRESS FOR THE DU11 IS ASSIGNED FROM THE FLOATING 
ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
DETERMINE LOCATION IF UNKNOWN. 
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* WHAT IS ITS CSR ADDRESS? [O R:160010-177700]: 
* IS IT A HALF DUPLEX LINE? [Y/N]: 
* HOW MANY SYNC CHAR.S ARE REQUIRED IN A SYNC LEADER? [D R:3.-14.]: 


A typical response is 4-6. If the line is to run at high 
speeds or the expected system load is to be heavy, then 
specify a greater number of sync characters. 


If the reply to the query for the number of DUl1ls was 
greater than 1, this query is repeated for each DU11. Note 
that the queries for interrupt vector, CSR, half duplex, and 
sync leader occur one after the other for each DUI11. The 
repeat sequence repeats all four queries. 


THE DUP11 PROVIDES A DOUBLE-BUFFERED PROGRAM INTERFACE BETWEEN A 
PDP-11l AND A SERIAL SYNCHRONOUS LINE. 
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THE DUP11 PROVIDES A FLEXIBLE INTERFACE IN THAT THE PROGRAMMER 
CAN SPECIFY THE SYNC AND CHARACTER SIZE. MODEM CONTROL 
CAPABILITY ALLOWS THE USE OF THE DUP11 IN SWITCHED OR DEDICATED 
APPLICATIONS. THE INTERFACE PROVIDES STRIP SYNC AND IDLE SYNC 
FEATURES TO SIMPLIFY PROGRAMMING AND REMOVE PROCESSOR OVERHEAD. 
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* HOW MANY DUP11 SYNC. LINE INTERFACES DO YOU HAVE? [D R:0.-16.]: 
* DO YOU WANT THE DRIVER TO BE LOADABLE? [Y/N]: 


; THE VECTOR ADDRESS FOR THE DUPI1 IS ASSIGNED FROM THE FLOATING 
; VECTOR SPACE STARTING AT 300. CONSULT FIELD SERVICE TO 
; DETERMINE THE LOCATION IF UNKNOWN. 


* ENTER VECTOR ADDRESS OF THE NEXT DUP11 [O R:300-774]: 


; THE CSR ADDRESS FOR THE DUP11 IS ASSIGNED FROM THE FLOATING 
; ADDRESS SPACE STARTING AT 160010. CONSULT FIELD SERVICE TO 
; DETERMINE LOCATION IF UNKNOWN. 


* WHAT IS ITS CSR ADDRESS? [O R:160010-177700]: 
* IS IT A HALF DUPLEX LINE? [Y/N]: 
* HOW MANY SYNC CHAR.S ARE REQUIRED IN A SYNC LEADER? [D R:3.-14.]: 


A typical response is 4-6. If the line is to run at high 
speeds or the expected system load is to be heavy, then 
specify a greater number of sync characters. 


The vector address, CSR address, half duplex, and_= sync 
character questions are repeated for each DUP11 specified. 


END PERIPHERAL OPTIONS 


There is a Significant delay at this point while device 
tables are generated for the null device and network device 
(if selected) and tables for all of the standard 
pseudo-devices. 


; AT THIS POINT WE RENAME THE ASSEMBLY COMMAND FILE 
; AND THE SYSTEM BUILD COMMAND FILE TO [11,2x] 
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PIP [11,2x] /RE=RSXASM.CMD;*,RSXBLD.CMD;* 


SGN runs under UIC [11,10] and produces five files which are 
recorded in the [11,10] file directory. Command files are 
conventionally stored in [11,20] or [11,24]. The preceding 
PIP commands, only one of which is actually issued, puts the 
command files into the proper directory. 


* DID YOU ANSWER THE SYSGEN QUESTIONS TO YOUR SATISFACTION? [Y/N]: 
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* IS DKl: 


If, for any reason, the query section dialogue included 
responses that would result ina user-tailored Executive 
which did not reflect the user's intentions, an N_ response 
to this query causes the files created by the query section 
to be deleted and the query section restarted. If the 
response is N, the following lines are displayed: 


IF YOU HAVE A REASONABLY GOOD UNDERSTANDING OF RSX-11M AND THE 

SYSGEN PROCESS (AIDED BY LISTING OF SGNEXEC, SGNPER, AND SGNTT) 

YOU CAN CORRECT MOST MINOR ERRORS BY EDITING THE FOLLOWING FILES: 
[11,10]RSXMC.MAC - EXECUTIVE OPTIONS, PERIPHERAL COMPONENTS 
[11,10]SYSTB.MAC - PERIPHERAL'S DATA BASES (DCB'S,UCB'S,SCB'S) 
[l1,2X]RSXASM.CMD - TO CHANGE LISTING DEVICE, ETC. 
[11,2X]RSXBLD.CMD -—- TO CHANGE MAP DEVICE, ETC. 


NOTE THAT CORRECTING ICS/ICR-1l1 AND UDC ERRORS BY EDITING IS NOT 
RECOMMENDED. 


THE ALTERNATIVE TO EDITING THESE FILES IS TO RUN THROUGH THE ENTIRE 
QUERY SECTION AGAIN. 


DO YOU WANT TO RESTART THE QUERY SECTION? [Y/N]: 


If you do not want to restart the query section, SYSGEN 
displays 


WE WILL PAUSE SO YOU CAN EDIT THE FILES. 


Otherwise, the query section is restarted. 


If no errors occurred during the running of the three query 
files, SYSGEN processing continues here. 


IF YOU ARE BUILDING A SPECIALIZED SYSTEM YOU 
MAY WISH TO EDIT THE FILES WHICH ARE PRODUCED 
BY THE QUERY SECTION. 


DO YOU WANT TO EDIT ANY OF THE QUERY SECTION OUTPUT FILES? [Y/N]: 


If the answer is Y, SYSGEN will pause to let you edit the 
output files. When you are finished editing, type RES AT. 
to continue SYSGEN. 


If LP:, NL:, or SY: was specified as the listing device, 
the next section is bypassed. 


In the following lines it is assumed that DKl1: was 
specified as the listing device. 


ALREADY INITIALIZED AND MOUNTED? [Y/N]: 


ALL 


DMO 
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If it has been, the queries concerning it are skipped. 
DK1l: 


DK1l: 


PLACE A FORMATTED DISK IN DKl: (WRITE-ENABLED) . 


IS THE DISK READY IN DK1:? [Y/N] 


This question causes the indirect file processor to suspend 
itself until the disk reaches operating speed. When the 
disk is ready, the user answers Y to this question. 


* IS THE DISK IN DKl: INITIALIZED AS A FILES-11 VOLUME? [Y/N]: 


* WHAT IS ITS LABEL? [S]: 


INS 
INI 
REM 


MOU 
MOU 
INS 
SET 
UFD 
REM 


If the disk is not initialized, an N answer will cause _ the 
disk to be initialized by the following commands, which 
install task INI, initialize the disk, and then remove INI. 
If the disk is already initialized, processing continues 
with the Mount (MOU) command. 


[1,5y] INI 
DK1:LIST/BAD= [AUTO] 
INI 


Whether or not the disk needs to be initialized, DKl: 
processing continues at this point. 


DK1:LIST 
DK1:/OVR 
[1,5y]UFD 
/UIC=[1,1] 
DK1: [11,3x] 
UFD 


* WAS DK1l: MOUNTED SUCCESSFULLY? [Y/N]: 
* WAS THE UFD CREATED (OR ALREADY ON THE DISK)? [Y/N]: 


ee NO 


a 
INS 
INS 
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If any error messages appeared when the MOU and UFD commands 
were issued, the user answers N to this question, and 
processing resumes with the SYSGEN prompt Is DK1: 
INITIALIZED AND MOUNTED, as given above. 


Processing continues at this point. 


NOW WE ASSEMBLE THE EXECUTIVE 


SMAC 
SBIGMAC/PAR=PAR14K 


The proper version of MACRO-ll is installed, according to 
whether or not the host system has at least 24K of memory. 
BIGMAC is the assembler of choice in this case, and is 
always chosen when at least 24K of memory is available. 


ASSEMBLING THE EXECUTIVE TAKES ANYWHERE FROM 20 
MINUTES (ON AN 11/70) TO 2 HOURS (ON AN 11/10). 
TAKE A BREAK. 
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SET /UIC=[11, 2x] 
TIM 

MAC @RSXASM 

TIM 

UNL LP: 
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The SET command establishes the default UIC. MACRO-11 is 
requested to run with RSXASM as an indirect command file. 
Note that MACRO-11 is running under [11,20] or [11,24] and, 
since RSXASM is part of an indirect file request, .CMD is 
the default file type. The assembly will require from 20 
minutes to 2 hours to complete, depending upon the hardware 
available and the configuration of the target system. 


If the DSS-1l1l and/or UDC-1ll or ICS/ICR-1l1 was selected for 
the target system, the following text and commands are 
displayed: 


NOW WE ASSEMBLE THE MODULES NECESSARY FOR TASKS TO ACCESS 
UDC-11, DSS-11 OR ICS/ICR-11 I/O MODULE REGISTERS WITHIN 
THE I/O PAGE. I/O MODULE TYPES ACCESSED DIRECTLY ARE: 


ICS/ICR-1l1: 


DIGITAL INPUT 
COUNTER INPUT 


DSS-11 INPUTS 
UDC-11: 


ANALOG OUTPUTS 
SINGLE SHOT DIGITAL OUTPUTS 
DIGITAL INPUTS 
COUNTER INPUTS 


If the ICS/ICR-11l was selected, the following question is 
asked: 


IS DIRECT ACCESS TO ICS/ICR-~-11 I/O MODULES REQUIRED? [Y/N]: 
If the UDC1l was selected, the following question is asked: 
IS DIRECT ACCESS TO UDC-11 I/O MODULES REQUIRED? [Y/N]: 


If either of these questions is answered Y or if DSS-1l 
Support was included, the following text is displayed: 


IN AN UNMAPPED SYSTEM ACCESS TO I/O MODULES IS 
THROUGH UNRESTRICTED REFERENCE TO THE I/O PAGE 

OR VIA A GLOBAL COMMON BLOCK THAT OCCUPIES THE SET 
OF PHYSICAL LOCATIONS RESERVED FOR THE DEVICE REGIS-— 
TERS. IF YOU WISH TO ACCESS THE DEVICE THROUGH THE 
COMMON BLOCK, YOU MUST EDIT THE FILE RSXMC.MAC UNDER 
UFD [11,10], AS SHOWN IN THE FOLLOWING EXAMPLE: 


Note, if you include the FORTRAN callable process I/0 
routines (See the RSX-11M I/O Drivers Reference Manual), the 
global common block is required. These are also required on 
an unmapped system. 
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For ICS/ICR-1l1: 


*PL ISScll 
I$$c1l=0 
*I ISSCOM=0 


for DSS-1ll: 

*T 

*PL ISSS11 

I$SSSll=l 

*I ISSSCM=0 
FOR UDC11 

*PL USSDI11 

USSD11=0 

*I USSDCM=0 
Finally: 


*ED 


In either case, 
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* DO YOU HAVE TO EDIT FILE RSXMC.MAC? [Y/N]: 


INS 
EDI 


REM 


[l, 
[11 


EDI 


the following question is asked: 


If this question is answered Y, the following commands are 


issued: 


5y] EDI 
,10]RSXMC.MAC 


You should now perform the required edits. The Line Text 
Editor (EDI) is then removed = and 


assembled. 


the correct modules 


[11,2x] ICTAB.ICR, [11,3x] ICTAB/-SP=[11,10] ICTAB 
[11,2x] ICOM.ICR, [11,3x] ICOM/-SP=[11,10]RSXMC, ICOM 
[11,2x]UDCOM.UDC, [11,3x]UDCOM/-SP=[11,10]RSXMC,UDCOM 
{[11,2x]ISCOM.IDS, [11,3x] ISCOM/-SP=[11,10]RSXMC,ISCOM 
[11,2x]DSSDI.IDS, [11,3x]DSSDI/-SP=[11,10]RSXMC,DSSDI 


MAC 


Whether or not DSS-11 and/or UDC-11 or ICS/ICR-11 support is 
selected, all processing continues here. 


The disk for Exec listings is dismounted. 


DMO DKl1: 


, 
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NOW WE BUILD THE CONCATENATED OBJECT MODULE FILE 
FOR THE EXECUTIVE. 


The assembly of the Executive results in the creation of a 
number of individual object module files. These individual 


files can 
substantial 


be concatenated into 
Savings in disk space. 


a 


Single file with a 
Later, during the build 
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phase, the Task Builder processes a library produced from 
this concatenated file to create the task image of the 
user-tailored Executive. 


PIP RSX.OBS=*.OBJ 
PIP RSX11M.OBJ/RE=RSX.OBS 
PIP RSX11S.OBJ/RE=RSX.OBS 


All existing object files cataloged under the default UFD 
are concatenated as a result of this command. The file 
RSX.OBS is then renamed RSX11M.OBJ if an RSX-11M system is 
being generated, or RSX11S.OBJ if an RSX-11S system is being 
generated. 


At this point, processing of SYSGEN.CMD is dependent on the 
type of distribution kit you are using. For those using the 
Single RKO5 distribution kit, the queries and text under the 
heading SECONDARY STORAGE FOR SINGLE RKO5 are applicable. 
For those using the dual RKO5 distribution kit, the queries 
and text under the heading DUAL RKO5 TRANSFER are 
applicable. Those using any other distribution kit are 
asked the next question, since all files, needed are on the 
disk. 


* DO YOU WANT TO GO DIRECTLY TO THE NEXT PHASE OF THIS SYSGEN? [Y/N]: 
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Since all files needed for a SYSGEN reside on an RKO6, RLO1, 
RMO3, or an RP disk, it is possible to invoke SYSGEN phase 2 
immediately. If this question is answered Y, the SYSGEN 
phase 2 command file will be entered. 


For RSX-lIM SYSGEN, the command file selected will be 
{[200,200]SYSGEN2.CMD. For RSX-11S SYSGEN, the command file 
selected will be [200,200J11SGEN.CMD. After phase 2, the 
command file will exit. 


WHEN THIS COMMAND FILE IS FINISHED, YOU MAY CONTINUE WITH 
THE NEXT PHASE OF THIS SYSGEN WITH THE FOLLOWING COMMAND: 


@SYSGEN2 
@11SGEN 


If SYSGEN phase 2 on RP disk is not selected, it may be done 
Manually at a later time by following the directions given 
at the end of the SYSGEN command file. At this point, RP 
processing terminates and the command file will exit. 


***KEKSECONDARY STORAGE ***** 
KKERORKKK 


****XSINGLE RKOS***** 
For purposes of SYSGEN using the single RKO5 distribution 
kit, the following section is necessary to determine the 
secondary storage device. Secondary storage devices can be 
one of the following: 
1. An RKO5 disk 
2. A cassette tape 


3. A DECtape 
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4. A magtape 
5. An RX01 floppy disk 


Questions are asked until one of these configuration types 
is established. For disk-tape configurations, two files, 
RSXBLD.CMD and RSX11M.OBJ, must be copied to backup’ tape 
for later restoration to the object disk. In addition, if 
the UDC-1l was included, the common block module UDCOM.UDC 
must be copied. If the ICS/ICR-11 was included, the files 
ICOM.ICR and ICTAB.ICR must be copied. 


NOW WE COPY THE BUILD COMMAND FILE, THE ASSEMBLY PREFIX 
FILE, THE UDC, DSS OR ICS/ICR FILES AND THE CONCATENATED 
OBJECT MODULES TO SECONDARY STORAGE. 


ee "6 NO TO 


SET /UIC=[1,2x] 
* IS YOUR SECONDARY STORAGE DEVICE AN RKO5 DISK? [Y/N]: 


The following instructions and commands are executed if the 
system has aS a secondary storage device an RKO5 disk. 


* ENTER DEVICE FOR SECONDARY DISK [S]: 
For the following commands, it is assumed as an example, 


that DKl: is the device entered. 


PUT THE UNMAPPED OBJECT DISK IN DK1: 
PUT THE MAPPED OBJECT DISK IN DK1: 
AND MAKE SURE THAT THE DRIVE IS WRITE ENABLED. 


ee we NO Ne MO 


IS THE DISK IN DKl: READY? [Y/N]: 

MOU DK1:MAPOBJ 

MOU DK1:UNMOBJ 

PIP DK1:/NV=[11,2x]RSXBLD.CMD,RSX11M.0OBJ 
PIP DK1:/NV=[11,2x]RSXBLD.CMD,RSX11S.0OBJ 
PIP DK1:/NV=[11,2x]UDCOM.UDC 

PIP DK1:/NV=[11,2x] ICOM.ICR,ICTAB.ICR 
PIP DK1:/NV=[11,2x] ISCOM.IDS,DSSDI.IDS 
PIP DK1i: [200,200] /NV=[11,10]RSXMC.MAC 
DMO DK1: 


INS [1,5y]FLX 
All other configurations, except the RX01, require the File 
Transfer Program (FLX) to copy the files to the medium. 
Thus, the proper version of FLX is installed. 

* IS YOUR SECONDARY STORAGE DEVICE A CASSETTE TAPE? [Y/N]: 
The following instructions and commands are executed if the 


system has as a secondary storage device cassette tape. 


PUT A BLANK CASSETTE IN DRIVE 0 


me we MO 


IS THE BLANK CASSETTE IN DRIVE 0 READY? [Y/N]: 
LOA CT: 

FLX CT:/ZE 

FLX Cf:/VE/BS:512.=[{11,2x]RSXBLD.CMD/RS,RSX11M.OBJ 
FLX CT:/VE/BS:512.=[11,2x]RSXBLD.CMD/RS,RSX11S.0OBJ 
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FLX CT: /VE/BS:512.=[11,2x] UDCOM.UDC/FB/RS 

FLX CT:/VE/BS:512.=[11,2x] ICTAB. ICR/RS/FB, ICOM. ICR/FB 
FLX CT: /VE/BS:512.=[11,2x] DSSDI.IDS/RS/FB, ISCOM. IDS/FB 
FLX CT:/VE/BS:512.=[11,10]RSXMC.MAC/RS 


* IS YOUR SECONDARY STORAGE DEVICE A DECTAPE? [Y/N]: 
The following instructions and commands are executed if 


system has as a secondary storage device a DECtape. 


PUT A BLANK DECTAPE IN DRIVE 0 


ee we NO 


IS THE BLANK DECTAPE IN DRIVE 0 READY? [Y/N]: 
LOA DT: 

FLX DT:/ZE 

FLX DT: /DO=[11,2x]RSXBLD.CMD/RS,RSX11M.OBJ 

FLX DT: /DO=[11,2x] RSXBLD.CMD/RS,RSX11S.0BJ 

FLX DT: /DO=[11,2x] UDCOM.UDC/FB/RS 

FLX DT:/DO=[11,2x] ICTAB. ICR/RS/FB, ICOM. ICR/FB 
FLX DT: /DO=[11,2x]DSSDI.IDS/RS/FB, ISCOM. IDS/FB 
FLX DT: /DO=[11,10]RSXMC.MAC/RS 


* IS YOUR SECONDARY STORAGE DEVICE A MAGTAPE? [Y/N]: 


The following instructions and commands are executed if 


the 


the 


system has as a secondary storage device a magtape (TU10, 


TS0O3, TU16). 


MOUNT A MAGTAPE IN DRIVE 0 


e+ se we we 


IS THE MAGTAPE IN DRIVE ZERO READY? [Y/N]: 
IS THE MAGTAPE DRIVE A TU16, TU45, or TE16? [Y/N]: 


The device mnemonic for TU16 or TU45 magtape is MM. 


The 


device mnemonic for TU1O and TS03 is MT. This guestion is 


used to select the proper sequence of commands. 


In the following commands, MT: will be replaced by MM: 
you answered Y to this question. 


LOA MT: 

FLX MT:/ZE 

FLX MT: /DO=[11,2x]RSXBLD.CMD,RSX11M.OBJ 

FLX MT: /DO=[11,2x] RSXBLD.CMD,RSX11S.0BJ 

FLX MT: /DO=[11,2x] UDCOM.UDC/FB/RS 

FLX MT: /DO=[11,2x] ICTAB. ICR/RS/FB, ICOM. ICR/FB 
FLX MT: /DO=[11,2x]DSSDI.IDS/RS/FB,ISCOM.IDS/FB 
FLX MT: /DO=[11,10]RSXMC.MAC/RS 


* IS YOUR SECONDARY STORAGE DEVICE AN RX01 FLEXIBLE DISK? [Y/N]: 


The following instructions and commands are executed if 
system has as a secondary storage device a floppy disk. 


LOA DX: 


PLACE A BLANK FLEXIBLE DISK IN DRIVE 0 


=e “Oe te 


* IS THE FLEXIBLE DISK IN DRIVE 0 READY? [Y/N]: 
INS [1,5y] INI 
INI DX0:SYSGEN 


if 


the 


REM 


A 


=e =e ~@ “es we “8 WE 


REM 
REM 


me te TO WSO NO MO NO NS NO MO NE TO 


Ye se se 
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INI 

DX0:SYSGEN 

[1,5y]UFD 

DxX0: [1,2x] 

UFD 
DX:=[11,2x]RSXBLD.CMD,RSX11M.OBJ 
DX:=[11,2x]RSXBLD.CMD,RSX11S.0OBJ 
DX:=[11,2x]UDCOM.UDC 
DX:=[11,2x] ICTAB. ICR, ICOM.ICR 
DX:=[11,2x]DSSDI.IDS,ISCOM.IDS 
DX:=[11,10]RSXMC.MAC 

DxX0: 


If none of the supported configurations is selected, the 
following text is displayed and the questions are repeated. 


KKK ERROR kk 


THE CONFIGURATION YOU ARE RUNNING ON IS NOT 


STANDARD SYSGEN CONFIGURATION. YOU MUST HAVE ONE OF 


THE COMBINATIONS OF DEVICES SPECIFIED ABOVE. WE WILL 
REPEAT THE CONFIGURATION QUESTIONS. 


Normal processing continues here after specific 
processing is completed. 


FLX 
PIP 


The FLX and PIP tasks are removed; their function has 


device 


been 


completed, and they are removed to bring the system back to 


its initial state. 


DISMOUNT THE SYSTEM DISK AND MOUNT THE 
UNMAPPED OBJECT DISK 

MAPPED OBJECT DISK 

IN DRIVE 0 AND BOOT IN THE SYSTEM ON THAT DISK 
WHEN THE SYSTEM IS UP, SET THE TIME AND DATE 
AND INITIATE THE INDIRECT COMMAND FILE 
[200,200]SYSGEN2.CMD. FOR EXAMPLE: 
[200,200]11SGEN.CMD. FOR EXAMPLE: 


>TIM 10:20 11/15/77 


>@SYSGEN2 
>@11SGEN 


ET /UIC=[200,200] 


****X*XDUAL RKO5 TRANSFER***** 


DMO DK1: 


The indirect command file SGNXFER.CMD transfers control from 
SYSGEN.CMD to Sysgen2.cmd. This transfer is necessary 
because the files SYSGEN and SYSGEN2 are on different disks. 


The unit that contains the EXECSRC disk is dismouned. The 
following assumes that the EXFCSRC disk was mounted in DKl:. 
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REMOVE THE EXECSRC DISK FROM DK1l:. BEFORE PROCEEDING TO THE NEXT 
PHASE OF SYSGEN, YOU MUST COPY THE SYSTEM DISK. IF YOU HAVEN'T 
DONE SO ALREADY. 


ue =e tO 


* HAVE YOU MADE A COPY OF THE SYSTEM DISK? [Y/N]: 


If you haven't made a copy, SGNXFER exits. To continue with 
SYSGEN, you must manually re-start [200,200] SGNXFER.CMD on 
the BASLINE disk. 


WE WILL EXIT NOW SO YOU CAN COPY THE SYSTEM DISK. TO 
CONTINUE WITH SYSGEN START [200,200]SGNXFER.CMD ON THE 
BASLINE DISK. 


—e se se 


If you have already copied the SYSTEM disk, SGNXFER 
continues. The unit that contained the EXECSRC disk is 


assigned to the pseudo device SY: and the RKO5 unit 
containing the BASLINE disk is assigned to the pseudo device 
LB:. 

ASN DKl: = SY: 

ASN DKN: = LB: 


If you are generating an RSX-11M system, the following 
section is omitted. 


**RSX-11S ONLY** 
Note that if you are generating an RSX-11S system and are 
using the RSX-11M dual RKO5 distribution kit, this section 
is omitted. 
; PUT THE 11S KIT DISK IN DKl: AND START IT UP (WRITE PROTECTED). 
* IS THE 11S KIT DISK READY? [Y/N]: 


This question is repeated until the disk is ready (Y 
response). 


MOU DKl: 11SKIT 

SET /UIC = [2,20] 

PIP LB: [2,20] /UF/NV/FO = SY:[2,20]*.* 

DMO DKl: 

**RSX-1L1M AND RSX-11S** 

; PUT THE SYSTEM DISK IN DKl: AND START IT UP (WRITE ENABLED). 
* IS THE SYSTEM DISK READY? [Y/N]: 


This question is repeated until the disk is ready (Y 
response). 


MOU DK1:SYSTEM 
; DELETE MAPPED OR UNMAPPED OBJECT LIBRARIES AND BUILD FILES 
SET /UIC=[1,2x] 
For a mapped system, the unmapped system files are deleted. 


PIP [1,20]*.*;*/DE 
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For an unmapped system, the mapped system files are deleted. 
PIP [1,24]*.*;*/DE 
SET /UIC=[1,5x] 


PIP @LB: [200,200] COPYTSK 
PIP /CO=LB:BADSYS.*,DSCSYS.*,PRESRV.* 


; COPY SYSTEM OBJECT AND BUILD FILES FROM BASLINE DISK 
SET /UIC=[1,2x] 


The proper object files are then copied. For an RSX~-11S 
system, the PIP command is 


PIP /NV=LB:RSXBLD.CMD,RSX11S.OBJ 
For an RSX-11M system, the PIP command is 
PIP /NV=LB:RSXBLD.CMD,RSX-11M.0OBJ 


If support for ICS/ICR, UDC-1l, or DSS-1l was included, the 
appropriate PIP commands are issued. 


For ICS/ICR, the PIP command is 
PIP /NV=LB:ICTAB.ICR,ICOM.ICR 
For UDC-ll, the PIP command is 
PIP /NV=LB:UDCOM.UDC 
For DSS-1l, the PIP command is 
PIP /NV=LB:DSSDI.IDS,ISCOM.IDS 
PIP [200,200] /NV=LB: [200,200]RSXMC.MAC 
* DO YOU WANT TO CONTINUE WITH THE NEXT PHASE OF SYSGEN! [Y/N]: 


If you do not wish to continue, instructions for doing so 
are given and SGNXFER exits. Otherwise, SGNXFER continues. 


SET /UIC=[200,200] 


The proper file is then invoked; SYSGEN2 for an RSX-11M 
system and 11SGEN for an RSX-11S system. 


End of SYSGEN phase l. 


3.4 SYSGEN2.CMD FILE DETAILS 


The user-tailored Executive is built under the direction of the 
indirect file SYSGEN2.CMD. At the completion of the assembly and 
configuration phases, directions were given to the single RKO5 user to 
bootstrap from the proper object disk, set the time, and initiate the 
indirect file SYSGEN2.CMD. The narrative which follows is a display 
of the SYSGEN2.CMD file. The conventions used in describing the 
SYSGEN.CMD file apply. 


° 
’ 


=e 78 6" WO 


wwe we te Ne Ne NO 


we we Me Ne NO Ne NE 


™~e we ™O Ne Me tO 


+ 
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SYSGEN PART 2 <VERSION 03.1> 


COPYRIGHT (C) 1975, 1976, 1977 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD THE EXECUTIVE AND ALL REQUIRED TASKS 


EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP IN THIS 
SYSGEN2 COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


DO YOU WANT EXPANDED COMMENTS FOR SYSGEN PART 2? [Y/N]: 


As in SYSGEN Phase 1, expanded comments provide much 
descriptive text which the experienced user may wish to 
dispense with. 


If you are using the single RKO5 distribution kit, you must 
copy the files from secondary storage to your object disk. 
The following text and queries are not displayed if you are 
uSing other than the single RKO5 kit. 


**SINGLE RKO5 KIT ONLY** 


THIS COMMAND FILE WILL PRODUCE THE TARGET SYSTEM ON THE DISK 
PACK CURRENTLY MOUNTED AS SY:. IT WILL REPLACE THE BASE-LINE 
SYSTEM THAT YOU ARE CURRENTLY RUNNING. YOU MUST SAVE 

THIS DISK BEFORE PROCEEDING ANY FURTHER IF YOU HAVEN'T 

DONE SO ALREADY. 


DO YOU WANT TO CONTINUE WITH SYSGEN PART 2? [Y/N]: 


This question allows the user to exit in order to preserve 
the disk before modifying it in building the target system. 


NOW WE COPY THE EXEC BUILD FILE, THE ASSEMBLY PREFIX FILE, THE 

UDC, DRS11/DSS11 OR ICS FILES AND THE CONCATENATED EXECUTIVE OBJECT 
MODULES FROM THE SECONDARY STORAGE MEDIUM TO THE SYSTEM DISK. 

IF DURING SYSGEN PART 1 YOU ANSWERED THAT YOUR SECONDARY 

STORAGE MEDIUM WAS AN RK DISK CARTRIDGE, THESE FILES 

WERE COPIED TO THE SYSTEM DISK AT THAT TIME. 


ARE THE FILES ALREADY ON THIS DISK? [Y/N]: 


If they are not, the indirect command file SYSGEN2A is 
called to copy them. If they are, SYSGEN2A is deleted. The 
following dialogue actually comes from SYSGEN2A (it appears 
only if you have not already copied the required files). 


Three files, RSXBLD.CMD, RSX11M.OBJ, and RSXMC.MAC must be 
on the system disk to complete SYSGEN phase 2. In addition, 
the files for the UDC, DRS/DSS11, or ICR/ICS-1l common 
blocks must also be on the system disk if user tasks are 
going to access the device registers. For all kits except 
the single RK0O5, these files are already on the disk and 
need not be copied. For the single RKO5 distribution kit, 
they must be transferred to the system disk. RSXBLD.CMD is 
the command file that directs’ the Task Builder in 
constructing the user-tailored Executive. It was built by 
the query section. RSX11M.OBJ is the concatenated object 
module file produced by PIP from the user-tailored Executive 


object modules during the assembly run _ following the 
completion of the dialogue program. RSXMC.MAC is’ the 
assembly prefix file produced by the query section. It is 


* IS YOUR 


+e se Ne 


LOA CT: 
INS SFLX 
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used to control the assembly of options selected during the 
running of the guery section. They were saved on the backup 
medium and now must be copied onto the object disk where 
they will be used to build the user-tailored Executive. For 
RP or RKO6 system disks, this question will not be issued; 
instead, control will pass immediately to the point where 
the three files are purged and the Executive library is 
created (under the leading All Kits). 


SECONDARY STORAGE DEVICE A CASSETTE TAPE? [Y/N]: 
If the host system is an RKO5-cassette system, the following 


commands will copy the required files from cassette to the 
system disk. 


MOUNT THE CASSETTE FROM SYSGEN PART 1 IN DRIVE 0 


IS THE CASSETTE IN DRIVE 0 READY? [Y/N]: 


FLX SY:=CT:RSX11M.0OBJ,RSXBLD.CMD 

FLX SY:=CT: ICTAB.ICR/FB, ICOM.ICR/FB 
FLX SY:=CT:UDCOM.UDC/FB 

FLX SY:=CT:ISCOM.IDS/FB,DSSDI.IDS/FB 
FLX SY: [200,200]=CT:RSXMC.MAC 


UNL CT: 


* IS YOUR 


ee we NO 


LOA DT: 
INS SFLX 


End of RKO5-cassette commands. Control passes to the point 
where the files are purged (under the leading ALL KITS). 


SECONDARY STORAGE DEVICE A DECTAPE? [Y/N]: 
If the host system is an RKO5-DECtape system, the following 


commands will copy the specified files from DECtape to the 
system disk. 


MOUNT THE DECTAPE FROM SYSGEN PART 1 IN DRIVE 0 


IS THE DECTAPE IN DRIVE 0 READY? [Y/N]: 


FLX SY:=DT:RSX11M.0OBJ,RSXBLD.CMD 

FLX SY:=DT: ICTAB.ICR/FB,ICOM.ICR/FB 
FLX SY:=DT:UDCOM.UDC/FB 

FLX SY:=DT:ISCOM.IDS/FB,DSSDI.IDS/FB 
FLX SY: [200,200] =DT:RSXMC.MAC 


UNL DT: 

* IS YOUR 
; 

* 

* 


End of RKO5-DECtape commands. Control passes to the point 
where the files are purged (under the leading ALL KITS). 


SECONDARY STORAGE DEVICE A MAGTAPE? [Y/N]: 
If the host system is an RKO5~-magtape system, the following 


commands will copy the specified files from magtape to the 
system disk. 


MOUNT THE MAGTAPE FROM SYSGEN PART 1 IN DRIVE 0 


IS THE MAGTAPE IN DRIVE 0 READY? [Y/N]: 
IS THE MAGTAPE DRIVE A TU16, TE16 OR TU45? [Y/N]: 


LOA 
INS 
FLX 
FLX 
FLX 
FLX 
FLX 
UNL 


LOA 
INS 
FLX 
FLX 
FLA 
FLX 
FLX 
UNL 
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If the magtape is a fTE16, TU16 or tTU45, the following 


commands are issued: 


MM: 

SFLX 
SY:=MM:RSX11M.0BJ,RSXBLD.CMD 
SY:=MM: ICTAB.ICR/FB, ICOM.ICR/FB 
SY :=MM:UDCOM.UDC/FB 
SY:=MM:ISCOM.IDS/FB,DSSDI.IDS/FB 
SY: [200,200] =MM:RSXMC.MAC 


MM: 
If the magtape is a TE10, TU10 or T1803, the following 
commands are issued: 

MT: 

SFLX 

SY:=MT:RSX11M.0BJ,RSXBLD.CMD 


SY:=MT: ICTAB.ICR/FB, ICOM.ICR/FB 
SY:=MT:UDCOM.UDC/FB 

SY:=MT: ISCOM.IDS/FB,DSSDI.IDS/FB 
SY: [200,200] =MT:RSXMC.MAC 

MTs: 


End of RK05-magtape commands. Control passes to the 


where the files are purged (under the leading ALL KITS). 


* IS YOUR SECONDARY STORAGE DEVICE AN RX01 FLEXIBLE DISK? [Y/N]: 


LOA 
; 
; 
* 


MOU 
PIP 
PIP 
PIP 
PIP 
PIP 
DMO 
UNL 


Hse we Ne Me Ne Ne 


If the host system is an RK floppy disk system, 


following commands will copy the specified files from floppy 


disk to the system disk. 


DX: 


MOUNT THE FLEXIBLE DISK FROM SYSGEN PART 1 IN DRIVE 0 


IS THE FLEXIBLE DISK IN DRIVE 0 READY? [Y/N]: 


DX: SYSGEN 
SY:/NV=DX:RSX11M.OBJ,RSXBLD.CMD 
SY:/NV=DX: ICTAB.ICR,ICOM.ICR 
SY: /NV=DX: UDCOM. UDC 

SY: /NV=DX: ISCOM.IDS,DSSDI.IDS 
SY: [200,200] /NV=DX:RSXMC.MAC 
DX: 

DX: 


End of RKO5-RX01 commands. Control passes to the 


where the files are purged (under the heading ALL KITS). 


If none of the supported configurations is specified, 


following error message is issued and the questions are 


repeated to determine the secondary storage medium 
during SYSGEN phase l. 


kkk ERROR xK*kKk 


YOU HAVE NOT CHOSEN ONE OF THE STANDARD SYSGEN SECONDARY 
STORAGE DEVICES. WE WILL REPEAT THE QUESTIONS. 


WERE THE FILES COPIED SUCCESSFULLY? [Y/N]: 


SYSGEN DIALOGUE DETAILS 


If not, you may repeat the questions or pause so that you 
May copy the files yourself. If successful, SYSGEN2.CMD 
continues. 


**ALL KITS** 


Note, if you are using the dual RKO5 distribution kit, you 
Must identify the RKO5 units that contain the BASLINE and 
SYSTEM disks. Control passes to this location after the 
files RSXBLD.CMD, RSX11M.0OBJ, RSXMC.MAC and, conditionally, 
ICTAB.ICR, ICOM.ICR, ISCOM.IDS, DSSDI.IDS, and UDCOM.UDC, 
are copied to the system disk; or, in the case of RP, RKO6, 
or dual RKO5 disk systems, control passes to this location 
immediately on determining the system type. 


* HAVE YOU ALREADY BUILT THE EXEC? [Y/N]: 


This question asks whether or not the Executive has been 
linked together by the Task builder. SYSGEN phase 1 does 
not link the Executive, it only assembles it. Therefore, 
the first time you encounter this question, it should be 
answered negatively. 


Typically, before a partition can be laid out, the user 
needs a Task Builder map of the newly built user-tailored 
Executive. This occurs later in SYSGEN2.CMD and may require 
a lengthy off-line analysis of partition layout for the 
target system. After analyzing the partition layout, 
SYSGEN2.CMD can be re-initiated. If, at this point, an 
affirmative answer is typed, the process of building the 
user-tailored Executive is skipped, and SYSGEN2.CMD advances 
to the dialogue for the partitioning phase of system 
generation. 


; DELETE ALL BUT THE LATEST VERSIONS OF THE TASK IMAGE 
; FILES FOR PIP, EDI, TKB, BIGTKB, VMR, AND BOO. 


SET /UIC = [1,5x] 
PIP PIP.TSK/PU EDI,TKB,BIGTKB, VMR, BOO 


SYSGEN2 may, at a later stage, call SYSGEN3 to build new 
versions of the task PIP, EDI, TKB, BIGTKB, VMR and BOO. 
After having done so, SYSGEN2 must be able to install the 
versions of these tasks which are, at this stage, the latest 
versions. The PIP command above is executed to make a later 
identification of those versions possible. 


INS SLBR 


If you are using an RLO1 or either of the RKO5 distribution 
kits, the file 11SGEN.CMD is deleted. 


PIP 11SGEN.CMD;*/DE 


If ICS/ICR, DSS, or UDC support was not selected previously, 
the next question is omitted. 


* DO YOU WANT TO BUILD THE UDC, DSS OR ICS/ICR DEVICE COMMON BLOCK? [Y/N]: 


AS DISTRIBUTED ON THE OBJECT DISK, THE SYSTEM OBJECT 

LIBRARY (SYSLIB) DOES NOT CONTAIN THE FORTRAN RUN TIME 

SYSTEM MODULES FOR THE LPS-11 MODULES, THE PURDUE ISA MODULES 
FOR THE UDC, DSS11/DRS11 OR ICS SUBSYSTEMS. THEY MUST BE 
ADDED IF YOU PLAN TO USE THESE ROUTINES IN YOUR TARGET SYSTEM. 


=e se tO NE TO 


SET /UIC = [1,1] 
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* DO YOU WISH TO ADD THE UDC/LPS/ICS/DSS ROUTINES TO SYSLIB? [Y/N]: 


If the answer to this question is N, the next section is 
bypassed. 


* DOES YOUR TARGET SYSTEM HAVE THE UDC-11 SUBSYSTEM? [Y/N]: 

LBR SYSLIB/RP=PURUDC 

* DOES YOUR SYSTEM HAVE THE DRS/DSS-11 DIGITAL I/O SUBSYSTEM? [Y/N]: 
* DOES YOUR SYSTEM HAVE THE ICS/ICR~11 SUBSYSTEM? [Y/N]: 

* DOES YOUR SYSTEM HAVE THE DSR11/DSS11 SUBSYSTEM? [Y/N]: 

LBR SYSLIB/RP = PURICR 

* DOES YOUR TARGET SYSTEM HAVE THE LPS-11 OR AR-11 SUBSYSTEMS? [Y/N]: 
LBR SYSLIB/RP = LPS 

* DO YOU WANT TO ADD THE PURDUE ISA ROUTINES TO SYSLIB? [Y/N]: 


The following command is issued only if you wish to. add 
these routines. 


LBR SYSLIB/RP = PURISA 


The next command is issued only if you are using the RLO1 or 
either of the RKO5 distribution kits. 


PIP PURISA.OBJ;*/DE,PURUDC;*,PURICR;*,LPS;*,LPA;* 


SET /UIC = 


REM LBR 


e ™~e “Oe Ne 


[1, 2x] 


DELETE ALL BUT LATEST VERSION OF EXEC BUILD COMMAND FILE, 
ASSEMBLY PREFIX FILE, AND ALL EXEC OBJECT LIBRARIES IF ANY. 


PIP RSXBLD.CMD/PU 
PIP RSX11M.OLB;*/DE 
PIP [200,200]RSXMC.MAC/PU 


=e ™8 tO 


NOW WE 


If a previous SYSGEN was not done on this disk, the file 
RSX11M.OLB will not exist. PIP will issue a warning message 
to this effect. 


BUILD THE EXEC LIBRARY 


Following the assembly of the user-tailored Executive, the 
individual object modules were concatenated into a single 
file named RSX11M.OBJ. Concatenation was performed to save 
space on the secondary medium. This file must be 
transformed into a library file for processing by the Task 
Builder (TKB). 


INS SLBR 
LBR RSX1L1IM/CR: 80. :640.:128.=RSX11M.OBJ 
PIP RSX11M.0BJ;*/DE !DELETE OBJECT MODULE FILE 


The preceding commands create a library file named 
RSX11M.OLB from the concatenated object file, and delete the 
no-longer-needed concatenated object file, thus freeing disk 
space. 
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However, if the distribution kit is other than an RLO1 or 
either of the RKO5 kits, the last command above is replaced 
by the command 


PIP RSX11M.0BJ/PU !DELETE ALL BUT LATEST OBJECT MODULE FILE 


REM PIP 


in order to preserve the latest object module file. 


* DO YOU WISH TO ADD USER WRITTEN DRIVER(S) TO THE EXEC? [Y/N]: 


As part of the SYSGEN process, the user's own specialized 
drivers can be included in the Executive. An affirmative 
answer to this question will guide the user in assembling 
the driver and device table modules, inserting them into the 
Executive object library, and modifying the Executive build 
command file to include the driver when the Executive is 
built. See the RSX-11M Guide to Writing an I/O Driver for 
additional information on writing drivers and including them 
in the system. 


If the response to the above question is affirmative, the 
following is displayed. 


If you do not wish to add user written drivers to. the 
Executive, the next display appears under the heading ALL 
SYSTEMS. 


*USER WRITTEN DRIVERS ONLY* 


SET /UIC=[200,200] 


~e we TO M8 Me MO NO NO Ne NS MO NE OM 
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WE WILL PAUSE WHILE YOU ASSEMBLE YOUR DRIVER(S) AND USRTB 


THE EXEC ASSEMBLY PREFIX FILE RSXMC.MAC IS ALREADY 


LOCATED UNDER UFD [200,200]. ASSUMING YOUR DRIVER(S) NAME IS 
WHERE XX IS THE DEVICE NAME (E.G., DK), THE FOLLOWING 
COMMANDS WILL ASSEMBLE THE DRIVER(S) AND THE USRTB MODULE. 


>RUN SMAC 

>RUN SBIGMAC 

MAC>XXDRV= [1,1] EXEMC/ML, [200,200] RSXMC,XXDRV 
MAC>USRTB=[1,1]EXEMC/ML, [200,200] RSXMC,USRTB 
MAC>~2Z 


At this point, the indirect file will pause while the user 
assembles the drivers and user device tables. 


NOW YOU MUST ADD YOUR DRIVER(S) AND USRTB MODULE 
TO THE EXEC OBJECT MODULE LIBRARY. THE FOLLOWING IS AN EXAMPLE: 


LBR>RSX11M/RP=[200,200] XXDRV,USRTB 
LBR>“Z 


SET /UIC=[1,2x] 


LBR 


REM LBR 


e 
iV 


When the Librarian prompts for input, the user. should _ type 
in a command to include the drivers and device table. 


YOU MUST NOW ADD COMMANDS TO INCLUDE YOUR DRIVER(S) AND USRTB 
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TO ADD DRIVER(S) INSERT COMMANDS OF THE FORM: 


RSX11M/LB: XXDRV 


MODULE INTO THE EXEC BY EDITING THE EXEC TASK BUILD COMMAND FILE. 


INTO THE COMMAND FILE IN THE PLACE WHERE THE OTHER DRIVERS ARE 


=e “se “6 “~e “8 “Oe EO 


=e swe tO 


e %e %O we NO NO NO NO MO Ne NO Me 


REFERENCED. XXDRV REPRESENTS THE NAME OF YOUR DRIVER(S). 


The next three lines are displayed only if you answered Y to 
loadable driver support. A loadable driver must not be 
specified in the TKB Command file to build the executive. 


NOTE: FOR THOSE DRIVERS WHICH YOU WANT TO BE LOADABLE, 
DO NOT INCLUDE CORRESPONDING COMMANDS TO ADD THEM TO 
THE EXECUTIVE. 


The next two lines are displayed regardless of whether you 


specified loadable driver support or not. 


THEN LOCATE THE LINE IN WHICH THE MODULE SYSTB IS REFERENCED 


AND ADD THE ENTRY FOR YOUR USRTB MODULE IMMEDIATELY AFTER IT. EG: 


{[1,2x]RSX11M/LB: LOADR:NULTK:SYSTB:USRTB:SYTAB: INITL 


FINALLY, LOCATE THE LINE: 
GBLDEF=SUSRTB: 0 


AND DELETE IT. 


’ 

INS SEDI 

EDI RSXBLD.CMD 
REM EDI 


=e se SO 


When the Line Text Editor (EDI) prompts, the user 
perform the required edits. 


YOUR NON-LOADABLE DRIVERS WILL AUTOMATICALLY BE LINKED 
WITH THE EXECUTIVE YOU ARE BUILDING. 


*ALL SYSTEMS* 


should 


Whether or not the user is adding a driver to the Executive, 
processing continues at this point. The word NON-LOADABLE 
is omitted if you did not specify loadable driver support. 


INS SBIGTKB 
INS STKB 


Only one of the above commands is issued to install _ the 


proper task builder. 


SET /UIC=[1,2x] 


° 
’ 
e 
a 
° 
’ 
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NOW WE BUILD THE EXECUTIVE 


KB @RSXBLD 


The correct version of the Task Builder is installed and 


used to build the Executive. The Task Builder 
controlled by the command file RSXBLD.CMD, which is 


(TKB) is 
created 


during the running of SGN (and possibly modified to include 


other drivers). 
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* DID THE EXECUTIVE BUILD SUCCESSFULLY? [Y/N]: 
If the reply indicates that it did not, the following is 
displayed. 


WE WILL PAUSE NOW SO THAT YOU CAN CORRECT THE PROBLEM. AFTER 
RESUMING, WE WILL BUILD THE EXECUTIVE AGAIN. 


~e ~e we 


The following text is displayed only when the UDC11l, DSSl1l, 
or ICS/ICR-11 is being included in the user's target system 
and the device common block is to be built. 


NOW WE BUILD THE UDC, DSS OR ICS/ICR DEVICE 
COMMON BLOCKS. A DEVICE COMMON BLOCK RESIDES 

ON THE I/O PAGE AND IS REFERENCED WHENEVER A TASK 
DIRECTLY ACCESSES ANY I/O MODULES. 
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TKB @UDCBLD 
TKB @ICBLD 


YOU MUST EDIT THE RESIDENT LIBRARY BUILD FILE 
FOR THE DSS11 COMMON BLOCK TO SET THE BASE OF 
THE 32-WORD BOUNDARY AT OR IMMEDIATELY BELOW 
THE FIRST DSS11 BUS ADDRESS SPECIFIED DURING 
SYSGEN PHASE 1. 


EXAMPLE OF EDITING COMMANDS TO SET 
THE BASE ADDRESS OF THE COMMON BLOCK: 


IF THE BASE PHYSICAL BUS ADDRESS OF THE 
DSS11 MODULES IS 160010 AND ONE MODULE 
IS INSTALLED, THE EDITING COMMANDS ARE: 


*L PAR 
PAR=ISCOM: XXXXXX: 400 ; 
*R PAR=ISCOM:160000:100 


=e "O8 ~O ue Ne NO WH NO NO TO VO NSH Te WO We TWH WO WS we 


*ED 
INS SEDI 
EDI [1,20] ISBLD.CMD 
REM EDI 
The EDI example and command appear only if you have 
specified that DSS-1l support is desired, and the target 
system is unmapped. When EDI prompts, the user’ should 
perform the required edits. 
TKB @ISBLD 
The TKB command occurs only if DSS-11l support is required. 
REM TKB 
SET /UIC=[1,1] 
INS SLBR 


LBR SYSLIB/RP=[1,20] ICOM.ICR 
LBR SYSLIB/RP=[1,20]UDCOM. UDC 
LBR SYSLIB/RP=[1,20]ISCOM.IDS 
LBR SYSLIB/RP=[1,2x]ICTAB.ICR 
LBR ISLIB/RP=[1,2x]DSSDI.IDS 
LBR SYSLIB/RP=[1,2x]DSSDI.IDS 
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Of the last two lines, only 1 will actually appear. The 
first command is executed if you have specified support for 
DSS-1l and UDC. The second command is executed if you 
specified support for DSS-1l only, or with ICR/ICS-ll. 


INS SPIP 

PIP [1,2x]*.ICR;*/DE 
PIP [1,2x]*.UDC;*/DE 
PIP [1,2x]*.IDS;*/DE 


Whether or not the UDC, DSS-11l, or ICS/ICR-1l is being 
included in the target system, processing continues at this 
point. 


REM LBR 

INS $PIP 

UNL LP: 

PIP [1,2x]ICBLD.CMD;*/DE,UDCBLD.CMD;*,ISBLD.CMD;* 


The TKB command files to build the device common blocks’ are 
deleted, unless your distribution kit is other than an RLO1 
or either of the RKO5s. 


YOU NOW NEED THE MAP OF THE EXECUTIVE TO LAYOUT 
THE PARTITIONS IN YOUR NEW SYSTEM. 


me ~Oe Ne TO 


* 


DO YOU HAVE THE MAP ALREADY? [Y/N]: 
LOA LP: 
PIP LP:=[1,3x]RSX11M.MAP 

UNL LP: 


a 


At this point, the user must find the symbol SSYTOP in the 
map. The symbol SSYTOP provides the value of the highest 
memory location occupied by the user-tailored Executive and 
is used for partition layouts. In an unmapped system, tasks 
are linked to the physical base address of the partition in 
which they run. To create an unmapped user-tailored system, 
the task-build command files for FCP, MCR, and TKTN must be 
edited if SSYTOP is above 30100(8). If SSYTOP is above 
40000(8), all other task-build command files must be edited, 
and the associated tasks must be rebuilt. In a mapped 
system, tasks are linked to a virtual base address’ rather 
than a physical base address and, thus, do not depend on the 
physical base address of the partition. 


LOOK IN THE MAP OF THE EXEC FOR THE SYMBOL SSYTOP WHICH 
INDICATES THE LAST ADDRESS ALLOCATED TO THE EXEC. USER 
PARTITIONS MAY START AT ANY LOCATION BEYOND THIS ADDRESS 

AS LONG AS THEY FALL ON A 64 BYTE BOUNDARY. SEE THE 

SYSGEN MANUAL FOR A DESCRIPTION OF HOW TO SET UP PARTITIONS. 
YOU MAY WISH TO STOP AT THIS TIME TO LAY OUT YOUR PARTITIONS. 


Hse se Se Ne NO Ne NO NO 


DO YOU WANT TO CONTINUE AND BUILD THE TASKS NOW? [Y/N]: 


If the user wishes to consider the partition layout, it is 
possible, at this point, to interrupt the SYSGEN phase 2 
process. See Chapter 4 for information on laying out 
partitions. At a later time, the user may restart 
SYSGEN2.CMD and pass control directly to the point where the 
system tasks are built. If the user specifies an exit from 
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SYSGEN phase 2 at this time, the following text is 
displayed. 


WE WILL EXIT NOW. WHEN YOU ARE READY TO RESUME 
THE BUILDING OF THE SYSTEM, EXECUTE THIS INDIRECT COMMAND FILE 
AND ANSWER Y TO THE FOLLOWING QUESTION: 

>* HAVE YOU ALREADY BUILT THE EXEC? [Y/N]: 


The SYSGEN process will shut down, allowing the user to lay 
out the partitions. After laying out partitions, the SYSGEN 
process can be resumed by rebootstrapping the system (if 
necessary) and starting SYSGEN2.CMD again. 


If the user elects to continue with the SYSGEN, processing 
continues at this point. 


INS SEDI 
INS SPIP 
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WE WILL NOW EDIT THE TASK BUILD COMMAND FILES 
AND BUILD THE REQUIRED TASKS. 


If a mapped system is being generated, the following text is 
displayed. 


MOST OF THE TASKS TO BE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY EITHER PARTITION 
SYSPAR OR GEN. SYSPAR IS A PARTITION WHICH IS 
ASSUMED TO BE 10000(8) BYTES LONG 

GEN IS A PARTITION WHICH IS 40000(8) BYTES LONG 


If an unmapped system is being generated, the following text 
is displayed. 


MOST OF THE TASKS TO BE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY EITHER PARTITION 
SYSPAR OR GEN. SYSPAR IS A PARTITION WHICH IS 
ASSUMED TO BE 7700(8) BYTES LONG 

AND IS ASSUMED TO BE BASED AT 30100(8). 

GEN IS A PARTITION WHICH IS 40000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 


The privileged tasks must always be rebuilt when the 
Executive has been rebuilt. The privileged tasks are linked 
to the Executive symbol table file and map into the 
Executive address space so that they may access various 


System lists and data structures. If the Executive is 
changed, these addresses change; thus, the tasks have to be 
rebuilt. 


The Line Text Editor (EDI) may be used to examine the PAR 
command line in each file that may require modification. 
Every file in question must be checked, since a Partitions 
command which does not reflect the requirements of the 
user-tailored system can produce tasks which will not run. 
A typical sequence as it would appear on the console is: 


>EDI BOOBLD.CMD 


[PAGE 1] 
*I, PAR= 
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PAR=GEN: 40000: 40000 
*KILL 
EDI>*2Z 
[EXIT] 


For an unmapped system, tasks built to run in SYSPAR have 
the Task Builder command: 


PAR=SYSPAR: 30100: 7700 

Those built to run in the GEN subpartition specify: 
PAR=GEN: 40000: 40000 

For mapped systems, the respective commands are: 


PAR=SYSPAR:0:10000 
PAR=GEN:0: 40000 


If alteration is necessary, the change may be accomplished 
as shown below. Suppose, for example, the GEN subpartition 
is to start at 50000(8). The above sequence would be 
changed to: 


>EDI BOOBLD.CMD 
[PAGE 1] 

*T, PAR 

PAR=GEN: 40000: 40000 
*C/4/5 

PAR=GEN: 50000:40000 
*EX 

[EXIT] 


SET /UIC=[1,2x] 


If loadable driver support has not been included and if you 
are using an RLO1 or either of the RKO5 distribution kits, 
the next command is issued to delete unnecessary files. 


PIP LOA.OLB;*/DE,LOADBLD.CMD;*,UNLBLD;* 


If you did not include LPA-11 support and if you are using 
an RLOl or either of the RKO5 distribution kits, the next 
command is issued to delete the LPA-1ll files. 


PIP LAINIT.OLB;*/DE, [200,200] BLDLAINIT.CMD;* 


IT IS POSSIBLE TO BUILD 3 VERSIONS OF THE FILE SYSTEM: 

1) 2K NON-MULTI-HEADER 

2) 2.5K MULTI-HEADER 

3) 5.5K FAST MULTI-HEADER 
THE NON-MULTI-HEADER FILE SYSTEM RESTRICTS FILES TO A 
MAXIMUM OF 26,112 BLOCKS OF 512 BYTES. THE MULTI-HEADER 
FILE SYSTEMS DO NOT ENFORCE THIS RESTRICTION. IF YOU 
ARE BUILDING A 16K SYSTEM, YOU MUST ALWAYS BUILD THE 2K 
FCP. FOR SYSTEMS WITH RP02/03/04/05/06 DISKS IT IS 
RECOMMENDED THAT YOU BUILD THE 5.5K FCP. BIGFCP IS 
STRUCTURED SO THAT IT STORES AS MANY FILE CONTROL BLOCKS 
(FCBS) IN ITS TASK IMAGE AS POSSIBLE BEFORE OVERFLOWING 
INTO THE DYNAMIC STORAGE REGION. AS DISTRIBUTED, THE 
BUILD COMMAND FILE ALLOCATES SPACE FOR 24. FCB'S. YOU 
MAY CHANGE THIS LIMIT BY EDITING THE BUILD COMMAND FILE. 
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DO YOU WISH TO BUILD THE BIG (5.5K) AND FASTER FILE SYSTEM? [Y/N]: 
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* DO YOU WANT TO BUILD THE 2.5K MULTIHEADER FCP? [Y/N]: 


It is possible to build different file systems: one 2K in 
size, with file size limited to 26,112 blocks, and 
relatively heavily overlaid; one 2.5K in size with no file 
size limit and heavily overlaid; and one a default of 5.5K 
in size, which is less overlaid, has a file size limited 
only by the capacity of the disk, and provides faster 
processing of file access requests. Note that the smallest 
(2K) file system does not support RMS record locking. (See 
Chapter 4 for details of the three versions of FCP.) AS a 
result of the answer to these questions, one of the 
following three questions is asked. 


BIGFCP'S BUILD FILE SELECTS PARTITION FCPPAR 
WHICH STARTS AT 100000(8) AND IS 

26000(8) LONG. IN MOST CASES, THESE LIMITS WILL 
HAVE TO BE ALTERED FOR YOUR SYSTEM. 
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For a mapped system partition FCPPAR starts at 0(8). 
* DO YOU HAVE TO EDIT THE 5.5K FCP TASK BUILD COMMAND FILE? [Y/N]: 


The default partition for the 5.5K FCP is FCPPAR, which is 
26000(8) bytes long. 


THE 2.5K FCP WILL BUILD TO RUN IN PARTITION 
SYSPAR, WHICH FOR THIS VERSION OF FCP MUST 

BE AT LEAST 10500 OCTAL BYTES BIG. 

IN MOST CASES, YOU HAVE TO EDIT THE BUILD FILE. 
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DO YOU NEED TO EDIT THE TASK BUILD COMMAND FILE FOR FCP? [Y/N]: 


The default partition for the 2.5K FCP is SYSPAR, which (for 
this version of FCP) has to be 10500(8) bytes long. For 
unmapped systems, it starts at 30100(8). You will almost 
certainly want to change this. 


THE 2K FCP WILL BUILD TO RUN IN 
PARTITION SYSPAR AS DEFINED ABOVE. 

YOU MUST EDIT THE BUILD COMMAND 

FILE IF YOU WANT TO CHANGE ITS PARTITION 
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DO YOU NEED TO EDIT THE TASK BUILD COMMAND FILE FOR FCP? [Y/N]: 


The default partition for the 2K FCP is SYSPAR, which is 
7700(8) bytes long. For unmapped systems, it starts at 
30100(8). 


Depending on the answer to the appropriate preceding 
question, one of the following three commands may be issued 
to allow editing of the correct task-build command file. 


EDI BIGFCPBLD.CMD 

EDI FCPBLD.CMD 

EDI FCPNMHBLD.CMD 

; THE TASKS MCR, MCRMU, AND TKTN NORMALLY RUN 

; IN PARTITION SYSPAR. IF YOU WISH TO CHANGE THE PARTITION NAME, 
; PUT ANY OF THESE TASKS IN OTHER PARTITIONS, 
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For a mapped system 


=e 


OR CHANGE THE LENGTH OF SYSPAR FROM 10000(8), 


For a unmapped system 


=e 


OR CHANGE THE BASE ADDRESS OR LENGTH OF SYSPAR, 


For both mapped and unmapped systems 
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If the previous question was 


YOU MUST EDIT THE TASK BUILD COMMAND FILES. 


THERE ARE TWO VERSIONS OF MCR AVAILABLE -- A SINGLE USER 
VERSION AND A MULTI-USER VERSION. THE SINGLE USER MCR 
PROCESSES ALL COMMANDS SERIALLY AND RUNS IN PARTITION 
SYSPAR. THE MULTI-USER VERSION CONSISTS OF TWO TASKS, 
MCRMU AND SYS. TASK MCRMU RECEIVES ALL COMMANDS IN 

THE NORMAL SERIAL MANNER, BUT IT PASSES MOST ON TO 

TASK SYS FOR PROCESSING. SINCE MULTIPLE COPIES OF 

SYS MAY BE RUNNING (ONE FOR EACH TERMINAL) A DEGREE 

OR PARALLELISM IS ACHIEVED. TASK MCRMU RUNS IN 
PARTITION SYSPAR WHILE TASK SYS RUNS IN GEN. 


DO YOU WANT TO BUILD THE MULTI-USER VERSION OF MCR? [Y/N]: 


answered affirmatively, the 


following question will be displayed. The EDI command will 
depend on the answer to the edit question. 


NOTE 


This sequence of two questions and an 
EDI command iS repeated many times 
further on in the command file. The 


operation is always 
therefore, a description 
given for each successive 


* DO YOU HAVE TO EDIT THE TASKBUILD FILE 
EDI MCRMUBLD.CMD 


the same; 
will not be 
one. 


FOR MCRMU AND SYS? [Y/N]: 


Note that MCRMUBLD.CMD controls the task~-build of both MCRMU 


and SYS. 


If you do not want the multi-user version of MCR, the 


following question is asked: 


* DO YOU HAVE TO EDIT THE TASK BUILD FILE FOR MCR? [Y/N]: 


EDI MCRBLD.CMD 


* DO YOU HAVE TO EDIT THE TASK BUILD COMMAND FILE FOR TKTN? [Y/N]: 


EDI TKNBLD.CMD 


The default partition for TKTN 


is SYSPAR. 


If support for ANSI format magtape was not selected during 
SYSGEN phase 1, the next section is bypassed. 


RUN IN PAR4K WHICH IS BASED AT 
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THE TASK MTAACP IS THE ANSI MAGTAPE FILE SYSTEM 
AND MUST BE BUILT IF YOU WISH SUPPORT FOR ANSI FORMAT 
MAGTAPE. THE TASK MTAACP WILL BUILD TO 


130000(8) AND REQUIRES ONLY 13000(8) BYTES. 
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THE TASK F11MSG IS THE MAGTAPE MESSAGE TASK, AND 
ISSUES MESSAGES FROM THE MAGTAPE ACP. IT WILL BUILD 
TO RUN IN SYSGEN AS DESCRIBED ABOVE. 
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If the target system is mapped, MTAACP will build to run in 
partition GEN, which is based at 0(8) and reguires only 
13000(8) bytes. 


* DO YOU HAVE TO EDIT THE TASK BUILD COMMAND FILE FOR MTAACP? [Y/N]: 
EDI MTABLD.CMD 

* DO YOU HAVE TO EDIT THE TASK BUILD COMMAND FILE FOR F11MSG? [Y/N]: 
EDI F11MSGBLD.CMD 


Processing continues here whether ANSI magtape support was 
selected or not. 


THE FOLLOWING TASKS PROCESS ADDITIONAL MCR COMMANDS: 

BOO, DMO, AT., INI, INS, LOA, MOU, SAV, UFD, AND UNL. 
THEIR TASK BUILD COMMAND FILES SPECIFY PARTITION GEN, WHICH IS 
8K WORDS (OCTAL 40000 BYTES) LONG. IF YOU WISH TO CHANGE THE 
PARTITION IN WHICH ANY OF THEM RUN, YOU MUST EDIT THE 
APPROPRIATE BUILD FILE. 
IN ADDITION, FOR UNMAPPED SYSTEMS PARTITION GEN 
IS ASSUMED TO START AT 40000. IF IN YOUR TARGET 
SYSTEM GEN'S BASE ADDRESS HAS CHANGED, YOU MUST 
EDIT THE BUILD COMMAND FILES FOR ALL OF THESE TASKS. 
IF THE ALTER-PRIORITY DIRECTIVE WAS NOT INCLUDED IN THE 
EXECUTIVE, YOU MUST EDIT THE COMMAND FILE FOR TASK AT. 
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DO YOU HAVE TO EDIT ANY FILES FOR MCR TASKS? [Y/N]: 


If the previous question is answered affirmatively, the 
following questions are displayed; depending on the user's 
response, the EDI command may or may not be issued. 


* DO YOU WANT TO EDIT TASK BOO'S BUILD COMMAND FILE? [Y/N]: 
EDI BOOBLD.CMD 
* DO YOU WANT TO EDIT TASK DMO'S BUILD COMMAND FILE? [Y/N]: 
EDI DMOBLD.CMD 
* DO YOU WANT TO EDIT TASK AT.'S BUILD COMMAND FILE? [Y/N]: 
EDI INDBLD.CMD 
* DO YOU WANT TO EDIT TASK INI'S BUILD COMMAND FILE? [Y/N]: 
EDI INIBLD.CMD 
* DO YOU WANT TO EDIT TASK INS'S BUILD COMMAND FILE? [Y/N]: 
EDI INSBLD.CMD 
* DO YOU WANT TO EDIT TASK MOU'S BUILD COMMAND FILE? [Y/N]: 
EDI MOUBLD.CMD 
* DO YOU WANT TO EDIT TASK SAV'S BUILD COMMAND FILE? [Y/N]: 
EDI SAVBLD.CMD 
* DO YOU WANT TO EDIT TASK UFD'S BUILD COMMAND FILE? [Y/N]: 
EDI UFDBLD.CMD 


The next two questions are displayed only if you selected 
support for loadable drivers. 


* DO YOU HAVE TO EDIT TASK LOA'S BUILD COMMAND FILE? [Y/N]: 
EDI LOABLD.CMD 
* DO YOU HAVE TO EDIT TASK UNL'S BUILD COMMAND FILE? [Y/N]: 
EDI UNLBLD.CMD 


The following text is always displayed. 
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THE TASKS HELLO AND BYE PROVIDE LOGIN/LOGOUT SUPPORT FOR 
MULTI-USER SYSTEMS. IF YOU SELECTED MULTI-USER PROTECTION 
SUPPORT DURING SYSGEN PART1, YOU MUST BUILD HELLO AND BYE. 
THE ACCOUNT FILE MAINTENANCE PROGRAM ACNT MUST ALSO BE 
BUILT TO CREATE AND MAINTAIN THE PASSWORD FILE. IN 
ADDITION, TWO OPTIONAL TASKS ARE AVAILABLE: 

BRO - BROADCAST MESSAGE TO TERMINALS 

SHUTUP - PERFORM ORDERLY SYSTEM SHUTDOWN. 
ALL OF THE DISTRIBUTED COMMAND FILES SPECIFY THAT THE 
TASKS RUN IS PARTITION GEN. 
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DO YOU WANT TO BUILD THE MULTI-USER PROTECTION TASKS? [Y/N]: 
DO YOU WANT TO BUILD THE MULTI~-USER UTILITIES? [Y/N]: 
DO YOU WANT TO EDIT THE BUILD FILES FOR HELLO, BYE, AND ACNT? [Y/N]: 


+ 


If you do not wish to build the multiuser protection tasks 
and are using an RLO1 or either of the RKO5 distribution 
kits a PIP command is issued to delete the unused files. 


PIP MLTUSR.OLB;*,ACNTBLD.*;*,BYEBLD.*;*,HELBLD.*;*/DE 


Similar commands are issued to delete other unused files. 
For brevity, these are omitted. 


IF YOUR TARGET SYSTEM DOES NOT HAVE A LINE PRINTER, YOU MUST 
; EDIT THE BUILD FILE FOR ACNT TO REMOVE THE ASSIGNMENT TO LP:. 
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* DO YOU HAVE TO EDIT THE BUILD FILES FOR HELLO, BYE, AND ACNT? [Y/N]: 


EDI ACNTBLD.CMD 

EDI BYEBLD.CMD 

EDI HELBLD.CMD 

* DO YOU HAVE TO EDIT THE BUILD FILES FOR BRO AND SHUTUP? [Y/N]: 
EDI BROBLD.CMD 

EDI SHUTUPBLD.CMD 


If you want to build any of the multi-user protection tasks, 
you must edit the appropriate task-build command file under 
one of the following conditions: the target system is 
unmapped and the GEN partition is not at 40000, or you want 
to change the partition. 


THE TASKS ERL AND ERF SUPPORT ERROR LOGGING. ERL IS THE 
ERROR LOGGER TASK, ERF TURNS ERROR LOGGING OFF. THEY MUST 
BE BUILT IF YOU SELECTED ERROR LOGGING SUPPORT DURING SYSGEN 
PART ONE. THE TASK BUILD COMMAND FILES BUILD BOTH TASKS TO 
RUN IN PARTITION GEN. 


DO YOU WANT TO BUILD THE ERROR LOGGING TASKS? [Y/N]: 
DO YOU HAVE TO EDIT THE BUILD FILES FOR ERL AND ERF? [Y/N]: 


%e we we we Ne we NO 


The remaining error logging tasks (PSE and SYE) are not 
privileged and, therefore, are not built during SYSGEN phase 
2. If you want to build the tasks PSE and SYE, you must do 
so at a later time (initiate SYSGEN phase 3 at the 
appropriate time). 


EDI ERFBLD.CMD 

EDI ERLBLD.CMD 

THE TASK ACS ALLOCATES/DEALLOCATES THE CHECKPOINT FILE 
IF YOU SELECTED SUPPORT FOR DYNAMIC ALLOCATION OF 
CHECKPOINT SPACE DURING SYSGEN PART 1, YOU MUST BUILD 
THIS TASK. IT WILL BUILD TO RUN IN PARTITION GEN. 
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* DO YOU WANT TO BUILD TASKS ACS? [Y/N]: 
* DO YOU HAVE TO EDIT TASK ACS'S BUILD COMMAND FILE? [Y/N]: 
EDI ACSBLD.CMD 


Again, edit task-build command files for tasks you want to 
build, if the GEN partititon start address has changed, or 
you want to change the partition. 


TASK PMD IS THE POST~MORTEM AND SNAP DUMP PROCESSOR. 

IT IS A PRIVILEGED TASK AND FOR CORRECT OPERATION IT SHOULD 

RUN IN A PARTITION WITH ONLY CHECKPOINTABLE TASKS. 

THE TASK BUILD COMMAND FILE BUILDS THE TASK FOR PARTITION 

PAR4K WHICH IS 20000(8) LONG 

AND IS ASSUMED TO START AT 130000(8). (Only displayed for unmapped 
systems) 
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* DO YOU WANT TO BUILD TASK PMD? [Y/N]: 

* DO YOU HAVE TO EDIT PMD'S BUILD COMMAND FILE? [Y/N]: 
EDI PMDBLD.CMD 


The task SHF..., referred to below, may only run in a mapped 
system. Therefore, the text associated with it will only be 
displayed during the building of mapped systems. 


TASK SHF IS THE SYSTEM CONTROLLED PARTITION TASK 
COMPACTION ROUTINE. IT WILL AGGLOMERATE FREE SPACE 

IN A SYSTEM CONTROLLED PARTITION ON REQUEST FROM 

THE EXECUTIVE. YOU MUST HAVE SELECTED DYN. MEM. ALLOC. 
DURING SYSGEN PART 1 FOR THIS TASK TO BE CALLED BY 

THE EXECUTIVE. IT NORMALLY RUNS IN PARTITION SYSPAR. 

THE PARTITION IT RUNS IN MUST NOT BE SYSTEM CONTROLLED. 
DO YOU WANT TO BUILD TASK SHF? [Y/N]: 

DO YOU HAVE TO EDIT TASK SHF'S BUILD COMMAND FILE? [Y/N]: 
EDI SHFBLD.CMD 


% Bue we we MO Ne Ne NO we 


THE TASK RMDEMO DISPLAYS SYSTEM STATUS ON A VTO5 OR VT52. 
IT DISPLAYS THE ACTIVE TASK, POOL STATUS, PARTITION 
LAYOUT, AND TASKS RESIDENT IN MEMORY. IT WILL BUILD 

FOR PARTITION GEN BUT ONLY REQUIRES 4K TO RUN AND 

USES LUN1 AS THE DISPLAY DEVICE. 


DO YOU WANT TO BUILD TASK RMDEMO? [Y/N]: 

DO YOU WANT TO BUILD IT FOR A VTO5? [Y/N]: 

DO YOU WANT TO BUILD IT FOR A VT52? [Y/N]: 

DO YOU HAVE TO EDIT TASK RMDEMO'S BUILD COMMAND FILE? [Y/N]: 
EDI RMDO5BLD.CMD 

EDI RMD52BLD.CMD 
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THE PRINT SPOOLER IS NOT DISTRIBUTED AS A TASK IMAGE. IF YOU 
WISH TO USE A PRINT SPOOLER IN YOUR TARGET SYSTEM, YOU MUST 
EXPLICITLY BUILD IT. THE TASK BUILD COMMAND FILE 

SPECIFIES PARTITION SPLPAR WHICH IS 10000(8) LONG 

AND IS ASSUMED TO START AT 130000(8). 
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The last line of the text above appears only if you are 
generating an unmapped system. 


If you wish to build the print spooler, you must’ answer 
affirmatively to the next question. 


* DO YOU WANT TO BUILD TASK PRT (PRINT SPOOLER)? [Y/N]: 
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The command file specifies that PRT be a checkpointable 
task; its performance can be improved by making it 
non-checkpointable. The command file also builds PRT to 
delete all spooled files after printing; this attribute can 
be altered. If either of these changes to PRT is desired, 
answer Y to the following question. 


THE DEFAULT PRINT SPOOLER WILL ONLY DELETE FLES NAMED 
LP.LST, LP.MAP, *.PMD, AND *.DMP. IF YOU WANT THE SPOOLER 
TO DELETE ALL FILES, YOU MUST EDIT THE BUILD COMMAND FILE. 
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The criteria for user-selectable file deletion in PRT is 
discussed in Chapter 4. 


* DO YOU WANT TO EDIT TASK PRT'S BUILD COMMAND FILE? [Y/N]: 
EDI PRTBLD.CMD 


NOW WE BUILD THE PRIVILEGED AND MCR TASKS. 
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INS $TKB 

INS $BIGTKB 

INS $PIP 

SET /UIC=[1,2x] 
PIP *.CMD/PU 


The SYSGEN procedure selects the proper version of the Task 
Builder, if the Task Builder is not already installed. This 
could be the case if SYSGEN2.CMD was terminated after 
building the Executive. The PIP command deletes all but the 
latest versions of the command files. 


* DO YOU WANT TO GENERATE THE MAPS FOR THE ABOVE TASKS? [Y/N]: 


In most cases, these maps are of little use to the user’ and 
are not needed. Therefore, a negative response is usually 
given. 


If, however, the maps are desired, the following is 
displayed. 


FOR THE SINGLE RKO5, DUAL RKO5 OR RLO1 DISTRIBUTION KITS, RUNNING 
STANDALONE, YOU MAY DIRECT THE TASK BUILDER MAPS TO THE LINE 
PRINTER, OR ANOTHER DISK OF THE SAME TYPE AS YOUR KIT. NOTE THAT 
THE MAPS WILL NOT FIT ON THE DISTRIBUTION DISKS FOR THE ABOVE. 


FOR OTHER DISTRIBUTION KITS, YOU MAY SPECIFY THE LINE PRINTER, 
THE DISTRIBUTION KIT DISK (SY0) OR A SECOND DISK OF THE SAME TYPE. 


FOR ALL ONLINE SYSGENS, YOU MAY SPECIFY ANY DISK WITH AT LEAST 
1400 FREE BLOCKS NOTE THAT SYSGEN WILL NOT LOAD THE DRIVER FOR 
THIS DISK. 
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WHAT IS TO BE THE MAP DEVICE? [DDU] [S]: 


The response is then assigned to the logical device MP:. 
The following assumes DKl: is to be the map device. 


ASN DK1:=MP: 


If you do not wish to print the maps, they are assigned _ the 
null device. 


ASN NL:=MP: 
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@BOOBLD 
BOO.OLB;*/DE, BOOBLD.CMD;*/DE 


The previous two commands build the task and delete the 
unused files. The unused files are deleted only if you are 
using an RLO1l distribution kit or either of the RKO5 
distribution kits. Similar commands will now be issued for 
all tasks that were selected to be built in the preceding 
sections. 


@DMOBLD 
DMOBLD.CMD; */DE 


@FCPBLD 
@FCPNMHBLD 
@BIGFCPBLD 


The selected version of the file control primitives is 
built. 


FCP.OLB;*,FCPBLD.CMD;*,BIGFCPBLD.*;*/DE 
@INDBLD 

IND.OLB, INDBLD.*;*/DE 

@INIBLD 

INIBLD.*;*/DE 

@INSBLD 

INS.OLD;*,INSBLD.*;*/DE 

@MCRBLD 

@MCRMUBLD 

MCRBLD.*;*/DE 

MCRMUBLD. *;*,SYSBLD.*;*/DE 
@MOUBLD 
MOU.OLB;*,INI.OLB;*MOUBLD.*;*/DE 


If ANSI magtape support was selected, the next two commands 
are issued. 


@F11MSGBLD 
F1IMSG.OLB;*,F11MSGBLD.OLD;*,.CMD;*/DE 
@MTABLD 

MTA.OLB;*,MTABLD.*;*/DE 

@SAVBLD 

SAV.OLB;*,SAVBLD.*;*/DE 

@TKNBLD 

TKNBLD.CMD;*/DE 

@UFDBLD 

UFD.OLB;*,UFDBLD.CMD;*/DE 


The next two commands are issued only if loadable device 
driver support was selected. 


@LOABLD 
@UNLBLD 
LOABLD.CMD;*,UNLBLD;*,LOA.OLB;*/DE 


The next command is issued only if the Post-mortem and Snap 
Shot Dump task was selected to be built. 


@PMDBLD 
PMD.OLB;*,PMDBLD.*;*/DE 


One of the next two commands is issued only if the system 
status display task RMDEMO was selected to be built. 


TKB 
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@RMDO5BLD 
@RMD52BLD 
RMD05.0OBJ;*,RMDO5SBLD.CMD;*/DE 
RMD52.0BJ;*,RMD52BLD.CMD;*/DE 


The next command is issued only when the 


routine was selected to be built. 


@SHFBLD 
SHUFL.OBJ;*,SHFBLD.CMD;*/DE 


memory compaction 


The next 2 commands are issued only if the print spooler was 


selected to be built. 


@PRTBLD 
PRT.OLB;*,PRTBLD.ODL;*,PRTBLD.CMD;*/DE 


* DO YOU WANT THE MAPS FOR THE MICRO CODE LOADER TASKS? 


INS STKB 


appear under the heading ALL SYSTEMS. 


**LPA-11 SUPPORT ONLY** 


The next set of commands are issued only if the multi-user 
protection tasks were selected to be built. 

@ACNTBLD 

ACNTBLD.*;*/DE 

@BYEBLD 

BYEBLD.CMD;*/DE 

@HELBLD 

HELBLD.CMD; */DE 
The next set of commands are issued only if the multi-user 
utility tasks were selected to be built. 

@BROBLD 

BROBLD.CMD;*/DE 

@SHUTUPBLD 

MLTUSR.OLB;*/DE 
The next command is issued only the checkpoint space 
allocation task was selected to be built. 

@ACSBLD 

ACSBLD.CMD;*/DE 

MCR.OLB;*/DE,SYSROT.OBJ;* 
The next 3 commands are issued only if the error logging 
tasks were selected to be built. 

@ERFBLD.CMD 

@ERLBLD.CMD 

ERF.OBJ;*/DE,ERL.OLB;* 
The following is displayed only if LPA-1ll support was 
included. 
If you have not included LPA-1ll support, the next queries 


[Y/N]: 


The proper version of the task builder is then installed. 


INS S$BIGTKB 


SET /UIC=[1,2x] 
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THE LPA-ll MAY BE LOADED WITH ONE OF THREE VERSIONS 
OF THE MICRO CODE: 


0 MULTI-REQUEST MODE 
1 DEDICATED MODE A/D INPUT 
2 DEDICATED MODE D/A OUTPUT 


%~e we Ne Ne Ne NO NO NO 


ENTER MICRO CODE VERSION DESIRED FOR LPA-11 #N[0 R:0-2 D:1]j: 


Note that N above is replaced by the unit being referenced 
(for example, the first time the question is asked, N is 
replaced by 0 and so on). 


* IS THE LAB I/O ON THIS LPA-11 AN ARI1? [Y/N]: 


The above two queries are repeated for each LPA-1ll unit 
specified. 


* DO YOU WANT TO EDIT THE LOADER TASK BUILD COMMAND FILES? [Y/N]: 


Editing the command file is necessary if you wish to change the 
partition name or, on an unmapped system, the partition base. The 
indirect command file [200,200]BLDLAINIT.CMD contains further details. 


If you want to edit the command files, EDI is installed to allow you 
to do so. 


INS SEDI 

EDI LAINIXBLD.CMD 
EDI LAINITBLD.CMD 
REM EDI 


The proper task builder commands are then issued. 


TKB @LAINIXBLD 
TKB @LAINITBLD 


PIP is then installed to delete the LPA-1ll files. 


INS S$PIP 
PIP LAINIXBLD.CMD;*/DE,LAINITBLD;* 


REM PIP 
REM TKB 


IN ORDER FOR THE LPA-11 MICRO CODE LOADER TO FUNCTION PROPERLY, 
ON POWERFAIL RECOVERY OR DRIVER LOAD YOU MUST HAVE THE 
FOLLOWING TASKS INSTALLED: 


LAINIT - THE MICRO CODE LOADER 

LAINO - LOADER REQUESTOR FOR LPA-1ll UNIT 0 
LAIN1I - LOADER REQUESTOR FOR LPA~-1l UNIT 1 
LAIN17 - LOADER REQUESTOR FOR LPA-11 UNIT 17(8) 


SYSGEN2, WHEN IT CREATES INSTALL.CMD, ONLY INSTALLS LAINIT AND 
LAINO. YOU MUST EDIT INSTALL.CMD TO INCLUDE THE OTHER REQUESTOR 
TASKS. IF THE REQUIRED TASKS ARE NOT INSTALLED, THE 

LPA-11 MICROCODE WILL NOT BE LOADED AUTOMATICALLY. 


me me Se MO NO MO NO TH TO TNS NO TH NO TO TO Ne NE 


**ALL SYSTEMS ** 
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PIP [200,200]BLDLAINIT.CMD;*/DE,LAINIT.OLB;* 


At this point, all tasks have been built. If the host 
system is running on an RKO5 disk, all object module 
libraries, task-build command files, and overlay description 
files are deleted, except for the Executive object library 
and task-build command file. 


PIP [200,200] /RE=RSXBLD.CMD,RSX11M.OLB 
PIP *.*;*/DE 
PIP [1,2x] /RE=[200,200]RSXBLD.CMD,RSX11M.OLB 


If maps were printed on the line printer, the next command 
unloads the LP driver. 


UNL LP: 


The next question is displayed only if loadable device 
driver support was selected. 


* DO YOU WANT TO BUILD ANY LOADABLE DRIVERS NOW? [Y/N]: 


If the answer is Y, the following questions and commands 
from the file BLDDRV.CMD are issued. 


If loadable drivers were not selected or if you do not wish 
to build them, the next display appears under the heading 
ALL SYSTEMS. 
*BUILDING LOADABLE DRIVERS ONLY* 
SET /UIC=[200,200] 


YOU MAY NEED THE TASK BUILD MAPS FOR THE DRIVER(S) FOR 
YOUR PARTITION LAYOUT. 


se we TO Me 


DO YOU WANT THE MAPS? [Y/N]: 


If the answer to this question is N, no maps will be 
generated for the loadable drivers. Otherwise, the maps 
will be output on the line printer if the system has one, or 
on the console terminal. One of the following three 
messages is displayed. 


THE MAPS WILL BE SPOOLED TO THE LINEPRINTER 
THE MAPS WILL BE PRINTED ON THE LINEPRINTER 
THE MAPS WILL BE PRINTED ON THE CONSOLE TERMINAL 


=e me MO NO 


If maps are directed to the line printer, the next command 
is issued to load the LP driver. 


LOA LP: 
SET /UIC=[1,2x] 


WHEN ALL DRIVERS ARE BUILT, STRIKE CARRIAGE RETURN WHEN ASKED 
FOR DEVICE MNEMONIC. 


we we te NO 


WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC? [S]: 
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The answer should be the 2-character device mnemonic for the 
(next) loadable driver to build; e.g., MT, followed by 
Carriage return. If a single carriage return iS answered, 
the driver build section is terminated. 


* WHAT IS THE DRIVER PARTITION NAME? [S]: 


The answer should be a l- to 6-character partition name 
where the driver is intended to run. 


* WHAT IS ITS PARTITION BASE ADDRESS? [S]: 


This question is displayed only if an unmapped system is 
being generated. The answer should be the base address 
(octal bytes) for the driver partition. 


TKB @[200, 200] XXDRVBLD 


This command builds the specified driver for the specified 
partition. XX is the driver mnemonic entered in response to 
a previous question. 


PIP [200,200] XXDRVBLD.CMD;*/DE 


INS SPIP 


~e se NO 


The command above deletes the command file that was used to 
build the driver. 


Processing now resumes with. the DEVICE MNEMONIC question, 
and the previous sequence is’ repeated to build the next 
driver. 


If no more drivers are selected to be built, the driver 
build section terminates. If maps were directed to the line 
printer, the following command unloads the LP driver. 


*ALL SYSTEMS* 


Whether or not loadable drivers were built, BLDDRV.CMD exits 
and processing will resume here in SYSGEN2.CMD. 


If a new line printer driver was built, the following is 
performed before the line printer is unloaded. Otherwise, 
it is omitted. 


BECAUSE UNLOAD WILL BE CONFUSED BY THE NEW LP DRIVER, 
WE WILL RENAME IT. BEFORE WE RUN VMR, WE WILL CHANGE 
IT BACK. 


SET /UIC=[1,5x] 
LPNEW.TSK/NV/RE=LPDRV.TSK 
LPNEW.STB/NV/RE=LPDRV.STB 


PIP 
PIP 


ONL 
REM 


SET 
INS 


Whether or not a new driver was built, the line printer is 
unloaded. 


LP: 

TKB 
If support for ANSI magtape was not selected, the next 
section is bypassed. 

/UIC=[1,1] 

$LBR 
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If the system disk is an RKO5 or RLO1, the FCS routines that 
handle ANSI magtape will now be inserted in SYSLIB. 


AS DISTRIBUTED, SYSLIB DOES NOT CONTAIN THE FILE CONTROL 
SERVICES SUBROUTINES FOR ANSI MAGTAPE SUPPORT. WE WILL NOW 
INSERT THEM INTO SYSLIB. 


NOTE: THESE ROUTINES CAUSE AN INCREASE IN THE SIZE 
OF MOST TASKS BUILT WITH THEM AS COMPARED TO 
THE NON-ANSI VERSION OF FCS. 


DO YOU WANT ANSI MAGTAPE SUPPORT IN SYSLIB? [Y/N]: 


LBR SYSLIB/RP=FCSMTA 
PIP FCSMTA.OBJ;*/DE 


HM we Me Ne NO Ne Ne NO NO Ne Ne NO Ne 


On the other hand, if the system disk is an RP or RKO6 disk, 
an alternative version of SYSLIB will be created, called 
ANSLIB. 


AS DISTRIBUTED, SYSLIB DOES NOT CONTAIN THE FILE CONTROL 
SERVICES SUBROUTINES FOR ANSI MAGTAPE SUPPORT. WE WILL NOW 
CREATE AN ALTERNATIVE VERSION OF SYSLIB, WITH THE FILE NAME 
"{[1,1JANSLIB", THAT CONTAINS THE ANSI SUPPORT ROUTINES. 

THIS LIBRARY SHOULD BE INCLUDED AS INPUT TO THE TASK BUILDER 
WHENEVER YOU BUILD A TASK THAT REQUIRES ANSI SUPPORT. 


NOTE: THESE ROUTINES CAUSE AN INCREASE IN THE SIZE 
OF MOST TASKS BUILT WITH THEM AS COMPARED TO 
THE NON-ANSI VERSION OF FCS. 
HAS ANSLIB ALREADY BEEN CREATED BY A PREVIOUS SYSGEN? [Y/N]: 


The following three commands are issued if this question was 
answered with an N. 


PIP ANSLIB.OLB;*/DE 
PIP ANSLIB.OLB/CO=SYSLIB.OLB 
LBR ANSLIB/RP=FCSMTA 


For all systems with ANSI magtape support, the next command 
is issued. 


REM LBR 


=e =e [6 MO ™O8 TO 


=e me ™e NO 


Whether ANSI magtape support was selected or not, processing 
continues here. 


THE UTILITY TASKS (MAC, PIP, TKB ETC.) ARE ALREADY BUILT TO RUN IN 
PARTITION GEN (EXCEPT BIGMAC AND BIGTKB WHICH ARE BUILT TO RUN 
IN PAR14K). IF YOU WISH TO CHANGE THE PARTITION IN WHICH ANY OF THEM 
RUN YOU MUST EDIT THE APPROPRIATE TASK'S BUILD COMMAND FILE 
AND REBUILD THE TASK. 

The following note appears only when building mapped systems. 


NOTE: FOR MAPPED SYSTEMS IT ISN'T NECESSARY 
TO REBUILD ANY OF THESE TASKS SINCE YOU 
MAY EXPLICITLY SPECIFY THE PARTITION IN 
WHICH THEY RUN AT INSTALL TIME. 


=e ~e ™e@ tO MO NO Ne MO 
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SINCE YOU HAVE SELECTED SUPPORT FOR ANSI MAGTAPE, 
YOU WILL PROBABLY WANT TO REBUILD PIP AND POSSIBLY 
OTHER UTILITY TASKS TO BE ABLE TO HANDLE ANSI MAGTAPES. 


THE USER MODE DIAGNOSTICS ARE NOT DISTRIBUTED AS TASK IMAGES. 
IF YOU WANT THEM, YOU HAVE TO BUILD THEM. 


If you are uSing an RLO1 or either of the RKO5 distribution 
kits, there is not enough disk space to rebuild any utility 
tasks or user mode diagnostics. 


The following is displayed if you are using the dual RKO5 
distribution kit. 


IF YOU WANT TO REBUILD THE UTILITY OR DIAGNOSTIC TASKS 
AND THE SYSTEM YOU ARE GENERATING HAS AT LEAST 24K OF 
MEMORY AND IT WILL RUN THE DISTRIBUTED TASKS, IT IS 
SUGGESTED THAT YOU REBUILD THEM USING YOUR SYSTEM DISK 
INSTEAD OF THE BASLINE DISK, AFTER SYSGEN2 IS COMPLETED. 
OTHERWISE, ANSWER YES TO THE FOLLOWING QUESTION. 


The following is displayed if you are using an RLO1 or 
Single RKO5 distribution kit. 


IF YOU WISH TO REBUILD THE UTILITY TASKS AND/OR BUILD THE USER MODE 
DIAGNOSTICS, YOU MUST DO SO AFTER SYSGEN PART 2 HAS BEEN COMPLETED. 
AT THAT TIME, MOUNT THE DISK LABELED "UTILITY OBJECTS" AND 

RUN THE INDIRECT COMMAND FILE [200,200]SYSGEN3.CMD 


If you are using a distribution kit other than an RLO1 or a 
Single RK05, the following question is asked: 


DO YOU WANT TO REBUILD UTILITIES AND/OR BUILD DIAGNOSTICS? [Y/N]: 


If you answer Y, the command file SYSGEN3.CMD (described in 
Section 3.5) is automatically called. However, if you are 
using the dual RKO5 distribution kit, the indirect command 
file SGNXFER2.CMD is used to transfer control. The 
following text, which actually comes from the file 
SGNXFER2.CMD, is displayed for dual RKO5 SYSGENS. 


*DUAL RKO5 KIT* 


The following assumes that the SYSTEM disk was mounted in 
DK1:. 


DMO DK1: 


e 
a 
° 
a 
e 
’, 


* 


REMOVE THE SYSTEM DISK FROM DK1l: AND REPLACE IT WITH 
THE UTILOBJ DISK. START UP THE UTILOBJ DISK (WRITE 
ENABLED) . 


IS THE UTILOBJ DISK READY? [Y/N]: 
The query is repeated until the disk is ready (Y response). 


The disk is then mounted and control passed to SYSGEN3.CMD 
(see Section 3.5). 


MOU DK1:UTILOBJ2 
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When SYSGEN3.CMD is completed, SGNXFER2.CMD continues. 


DMO DK1: 


e 
a 
e 
’ 


* 


REMOVE THE UTILOBJ DISK FROM DK1l: AND REPLACE IT 
WITH THE SYSTEM DISK. 


IS THE SYSTEM DISK READY? [Y/N]: 


The query is repeated until the disk is ready (Y response). 
The disk is then mounted and the new tasks are copied to the 


system disk. 


MOU DK1:SYSTEM 


2 
’ 
e 
’ 


WE WILL NOT COPY THE NEW TASKS TO THE SYSTEM DISK. 
‘PIP IS THEN INSTALLED AND THE TASKS COPIED. 


*ALL KITS* 
Processing of SYSGEN2.CMD continues here. 


SET /UIC=[1,5y] 
INS SPIP;-1l 


Awe me we NO NO 


wwe we Ne Ne tO Me NO NS NO Ne Ne NO NO 


The following text and questions appear only when 
mapped target systems. 


If you are building an unmapped system, the next 
appears under the heading ALL SYSTEMS. 


*MAPPED SYSTEMS ONLY* 
YOU NOW MUST SPECIFY WHETHER THE MEMORY SIZE WHICH YOU 
SPECIFIED FOR YOUR TARGET SYSTEM IN SGN DURING SYSGEN 
PHASE ONE IS GREATER THAN 32K WORDS 


IS YOUR TARGET SYSTEM LARGER THAN 32K WORDS? [Y/N]: 


building 


display 


If the answer to this question is affirmative, the following 


text is displayed. 


If you respond negatively, the next display appears 


the heading ALL SYSTEMS. 


IF YOU EVER WISH TO FIX TASKS ABOVE 32K OR LOAD DRIVERS 
ABOVE 32K AND SAVE THE SYSTEM OR IF THE TASK SAV 

(WHICH NORMALLY RUNS IN GEN) IS EVER TO BE RUN ABOVE 
32K, YOU MUST CREATE A LARGER COPY OF YOUR TARGET SYSTEM 
WITH PIP AT THIS TIME. 


NOTE: IT IS NOT POSSIBLE TO BOOT A VIRGIN MAPPED 
SYSTEM WHICH HAS DRIVERS LOADED ABOVE 27.5K FROM 
AN UNMAPPED SYSTEM. IT IS, HOWEVER, POSSIBLE TO 
BOOT A SAVED MAPPED SYSTEM WITH ANY CONFIGURATION 
FROM ANY UNMAPPED SYSTEM. 


DO YOU WISH TO CREATE A LARGER COPY OF YOUR SYSTEM? [Y/N]: 


under 


If the answer to this question is affirmative, the following 
text is diplayed. Otherwise the next display appears under 


the heading ALL SYSTEMS. 
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TO CREATE A SYSTEM IMAGE IN WHICH TASK IMAGES MAY BE FIXED UP 
TO M K WORDS, OR IN WHICH THE TOP OF SAV MAY BE AS HIGH 

AS M K WORDS, YOU MAY CALCULATE THE NUMBER OF BLOCKS (N) 
NEEDED AS FOLLOWS: 


N=(4*M) +2 
FOR EXAMPLE A 40K SYSTEM WOULD USE (40.*4)+2=162. BLOCKS 


NOTE: SAVE IMAGES ON THE 11/70 ARE CURRENTLY 
SUPPORTED ONLY TO A MAXIMUM OF 124K WORDS 
(I.E. N=498.) ALSO, THE NUMBER OF BLOCKS 
IS ASSUMED TO BE OCTAL. TO SPECIFY A 
DECIMAL NUMBER, APPEND A TRAILING DECIMAL POINT. 


FOR SINGLE RKO5 DISTRIBUTION KITS, THE 
MAXIMUM SYSTEM IMAGE SIZE IS 64K (258. 
BLOCKS) DUE TO A LACK OF CONTIGUOUS SPACE. 


ese me se “@ “eo “~e@ “oe “Te TO “8 We Me WH “WS TWH “SO We “WS WH WE 


ENTER THE NUMBER OF BLOCKS FOR YOUR SYSTEM IMAGE FILE [S]: 
PIP is now invoked to copy the system image file. For 
example, if the response to this question is 162., the 
command will be: 

PIP RSX11M.SYS/CO/NV/BL:162.=RSX11M.TSK 

The next lines are displayed only if the size of the system 


is less than 32K or if the user did not want to extend the 
Size of the system image file. 


WE WILL NOW MAKE A COPY OF YOUR TARGET SYSTEM 


I se se te 


IP RSX11M.SYS/NV=RSX11M.TSK 


No matter how large the target system is the processing of 
text and commands continues at this point. 


*ALL SYSTEMS* 
SET /UIC=[1,5y] 


RSX11M.TSK IS A BACKUP COPY OF THE EXECUTIVE YOU JUST BUILT. 
IF YOU DO NOT WISH TO RETAIN IT, WE WILL DELETE IT NOW. 


~ se se te NO 


DO YOU WISH TO DELETE THE SYSTEM BACKUP FILE RSX11M.TSK? [Y/N]: 


The normal reason (aside from backup) for retaining the 
RSX11M.TSK file is to be able to set up two or more systems: 
one for program development, and one for production; or two 
systems with different partition layouts. If the answer to 
this question is affirmative, the following command is 
issued: 


PIP RSX11M.TSK;0/DE 


In all SYSGENs, the following text is displayed to guide the 
user in setting up partitions and installing tasks into the 
target system Executive. 


REM PIP 


s 
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YOUR TARGET SYSTEM IS NOW READY TO SET UP PARTITIONS AND INSTALL 
THE REQUIRED TASKS. THE PROCEDURE TO FOLLOW ONCE VIRTUAL MCR 
IS RUNNING IS: 
1) EXTENDED POOL SPACE TO BASE OF FIRST PARTITION 
2) SET UP YOUR PARTITIONS 
2A) SET UP UDC, DSS OR ICS/ICR-11 COMMON BLOCK 
3) INVOKE THE INDIRECT FILE INSTALL.CMD IN VMR TO 
INSTALL THE PRIVILEGED TASKS YOU JUST BUILT 
4) LOAD ANY LOADABLE DRIVERS THAT YOU WANT RESIDENT 
IN THE SYSTEM IMAGE. IF THE TERMINAL AND/OR SYSTEM DISK 
DRIVERS ARE LOADABLE, THEY MUST BE LOADED USING VMR. 
5) EXIT FROM VIRTUAL MCR AND BOOT IN YOUR TARGET SYSTEM 


xe se Ne Ne Oe Ne we Se Se Se Ne Me NO 


DO YOU WANT A VMR EXAMPLE DISPLAYED? [Y/N]: 


If you answer Y to this question, a VMR example that depicts 
your system requirements is displayed. Since the example 
displayed depends on the options you select during SYSGEN, 
it is omitted here. 


THE FILE [200,200] INSTALL.CMD CONTAINS COMMANDS 
TO INSTALL ALL THE PRIVILEGED TASKS THAT YOU BUILT 
IN YOUR TARGET SYSTEM. 
YOU MAY WISH TO EDIT INSTALL.CMD TO INCLUDE OTHER TASKS. 
NOTE - IF YOU INSTALL A TASK 
WITH VMR THAT WAS NOT BUILT DURING 
THIS SYSGEN, YOU CANNOT RUN THAT TASK 
IN THE CURRENT SYSTEM! 
THIS IS TRUE FOR BOTH MAPPED AND UNMAPPED 
TARGET SYSTEMS, AND FOR BOTH PRIVILEGED 
AND NON-PRIVILEGED TASKS. THEREFORE, 
BOOT THE NEW SYSTEM IMMEDIATELY 
AFTER SYSGEN HAS FINISHED, OR AVOID 
INSTALLING TASKS WITH VMR THAT WERE 
NOT BUILT DURING THIS SYSGEN. 


Hse Ne Se Se Ne Ne Ne Ne Ne Se Ne Ne Ne Ne Ne Ne NO 


DO YOU WANT TO EDIT INSTALL.CMD? [Y/N]: 


SYSGEN phase 2 has created the file [200,200] INSTALL.CMD 
which will be used by VMR to install all the privileged 
tasks that have been built. If you want to edit that file, 
answer Y. 


INS [1,5y]EDI;-1 

SET /UIC=[200,200] 

EDI INSTALL.CMD 

SET /UIC=[1,5y] 

REM EDI 

; NOW WE WILL RUN VIRTUAL MCR SO THAT YOU MAY INITIALIZE 
; YOUR SYSTEM. 


v 

INS $BOO;-1 
INS SVMR;-l 
ASN SY:=LB: 
VMR 


WHEN THE INDIRECT FILE EXITS, BOOT IN YOUR TARGET SYSTEM, 
SET THE DATE AND TIME, AND SAVE THE SYSTEM WITH A BOOTSTRAP. 
WHEN YOUR SYSTEM REBOOTS ITSELF, PURGE THE OLD TASK FILES. 


E.G., 
>BOOT RSX11M 


=e =6 “=e “8 “Se OS SO 
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RSX11M V03.1 BL22 
>TIM 1/1/77 12:00:00 
>SAV /WB 


RSX11M V03.1 BL22 28K 
>RED DK0O:=SY: 

>MOU DKO:UNMOBJ 

>@{[1,2] STARTUP 

>* PLEASE ENTER TIME AND DATE (HH:MM MM/DD/YY) [Sl]: 
>TIM 1/1/77 12:01 

>@ <EOF> 

>SET /UIC=[1,50] 

>RUN SPIP 

PIP>*.*/PU 

PIP>°Z 

> 


=e “8 se@ Se TO ™O8 NO MO TE TO 6M LUMO UME lhUMO lL UNO UO hE UNO 


If you selected multiuser protection, the following reminder 
is displayed. 


; DON'T FORGET TO CREATE ACCOUNTS AFTER SAVING YOUR SYSTEM 


The user should bootstrap the user-tailored Executive, using 
the previous commentary as a model. 


3.5 SYSGEN3.CMD FILE DETAILS. 


SYSGEN part 3 builds selected utility tasks, and/or user mode 
diagnostic tasks. For SYSGENS uSing any distribution kit except the 
RLO1 or single RKO5, SYSGEN3 is performed as part of SYSGEN2, if the 
following question is answered with a Y. 


* DO YOU WANT TO REBUILD UTILITIES AND/OR BUILD DIAGNOSTICS? [Y/N]: 


If you are using an RLO1] kit or the single RKO5 kit, there is not 
enough on-line disk storage to do SYSGEN3 during SYSGEN2, and the 
previous question does not appear during SYSGEN2. In such systems, 
SYSGEN3 must be invoked manually after SYSGEN2 has finished using the 
Utility Object Disk (which is part of all distribution kits) as the 
system disk. The appropriate command is then: 


>SET /UIC=[200,200] 
>@SYSGEN3 


This section describes details of the SYSGEN3 procedure. 


SYSGEN PART 3 <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD SELECTED UTILITY TASKS AND/OR USER MODE 
DIAGNOSTICS. 


EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP IN THIS 
SYSGEN3 COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 
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* DO YOU WANT EXPANDED COMMENTS FOR SYSGEN PART 3? [Y/N]: 


The following section of the dialogue establishes certain 
parameters concerning the current system and the target 
system. If SYSGEN3 has been called from SYSGEN2, after 
answering Y to the question 


* DO YOU WANT TO REBUILD UTILITIES AND/OR BUILD DIAGNOSTICS? [Y/N]: 


These parameters are already known, and the following 
section is bypassed. 


* ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N]: 
If the current system has less than 24K words of memory, the 


utility tasks cannot be built. The following message is 
displayed and SYSGEN3 terminates... 


SORRY, YOU CANNOT BUILD ANY UTILITIES WITH A MACHINE 
SMALLER THAN 24K WORDS! 


=e ~e te NO 


If the system has enough memory, processing continues here. 
* ARE YOU BUILDING A MAPPED SYSTEM? [Y/N]: 
The following questions are asked to determine the 
distribution kit you are using. An affirmative answer 
suppresses further distribution kit queries. 
* DO YOU HAVE THE SINGLE RK0O5 DISTRIBUTION KIT? [Y/N]: 
If not, the next question is asked. 


* DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 


If you have this kit, you must then identify the RKO5 units 
that contain the BASLINE and UTILOBJ disks. 


If you do not have the dual RKO5 kit, the next two queries 
are omitted. 


* IN WHICH RKO5 UNIT IS THE BASLINE DISK MOUNTED?: 
* IN WHICH RKO5 UNIT IS THE UTILOBJ DISK MOUNTED?: 

These are then assigned to LB: and SY:. 
* DO YOU HAVE THE RLO1 DISTRIBUTION KIT? [Y/N]: 


* ARE YOU RUNNING ON A MACHINE WITH A LINEPRINTER? [Y/N]: 
* WAS ANSI MAGTAPE SUPPORT SELECTED IN SYSGEN PART 1? [Y/N]: 


Processing continues here LE SYSGEN3 was called 
automatically from SYSGEN2. 


* WAS USER MODE DIAGNOSTIC SUPPORT SELECTED IN SYSGEN PART 1? [Y/N]: 


Since SYSGEN3 may be called to build either utility tasks or 
user mode diagnostic tasks or both, the following two 
questions are asked to determine further action. (The 
second question is asked only if user mode diagnostic 
support was selected in SYSGEN part 1.) 
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* DO YOU WANT TO REBUILD ANY UTILITY TASKS? [Y/N]: 


If user mode diagnostic support was not selected in part 1, 
you cannot build the user mode diagnostics. Therefore, if 
not selected previously, the next question is omitted. 


* DO YOU WANT TO BUILD ANY USER MODE DIAGNOSTICS? [Y/N]: 


=e ~e “Oe Ne NOB NO NO MO NO NS 
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The responses to the above queries determine which of the 
following sections will be displayed. 


If you wish to rebuild any of the utility tasks and none of 
the user mode diagnostics, only those queries under the 
heading UTILITY TASKS are displayed. The queries under’ the 
heading USER MODE DIAGNOSTICS are omitted. 


If you wish to build user mode diagnostics (provided that 
user mode diagnostic support was selected in part 1) and not 
rebuild any utility tasks, only those queries under’ the 
heading USER MODE DIAGNOSTICS are displayed. The queries 
concerning rebuilding utility tasks are omitted. 


If you wish to rebuild utility tasks and also build user 
mode diagnostics, both sections are displayed. 


***UTILITY TASKS*** 


IN ORDER FOR THE UTILITY TASKS TO USE ANSI FORMAT TAPE 
THEY MUST BE BUILT WITH THE ANSI FCS ROUTINES. THESE 
ROUTINES MAY CAUSE CERTAIN TASKS TO INCREASE BEYOND THE 
NORMAL 8K SIZE. 


IF YOU WANT TO BUILD THE UTILITY TASKS WITH 
ANSI MAGTAPE SUPPORT, YOU HAVE TO EDIT THE TASK 
BUILD COMMAND FILES FOR THESE TASKS. 


The task-build command file for a particular utility task 
has to be edited only if the task size turns out to be above 
8K words. This means that SYSGEN3 may have to be run a 
second time. 


YOU MUST ALSO INCLUDE THE FILE CONTROL SERVICES ROUTINES 
FOR ANSI MAGTAPE SUPPORT IN SYSLIB. 


As described above, you must include the ANSI magtape FCS 
routines in SYSLIB, if you have selected ANSI magtape 
support. It is possible that these changes to SYSLIB have 
already been made by a previous SYSGEN3 on this disk. If 
so, answer Y to the next question. 


* IS SYSLIB ALREADY CORRECT FROM A PREVIOUS RUN OF THIS FILE? [Y/N]: 


INS $PIP 
INS $LBR 


If the answer to this question is Y, the next section is 
bypassed. Otherwise the following commands create a new 
version of SYSLIB. 


If you are uSing the dual RKO5 kit, the RKO5 unit containing 
the BASLINE disk is assigned to the pseudo device SY:. 
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ASN DKn:=SY:3 
SET /UIC=[1,1] 


If you are using an RLO1 kit or either of the RKOS5 kits, the 
following command is issued. 


PIP SYSLIB.OLB;*/DE 
PIP SYSLIB.OLB=SYSLIB.VIR 


If you want the utility tasks to support ANSI magtape, 
answer Y to the next question, and the following command is 
executed to include the FCS routines in SYSLIB. 


* DO YOU WANT THE UTILITY TASKS TO SUPPORT ANSI MAGTAPE? [Y/N]: 
LBR SYSLIB/RP=FCSMTA 


Further processing for an RKO5 system continues with the REM 
PIP command below. 


For systems with an RP, RKO6, RM0O3 as system disk, if ANSI 
IMagtape support was selected, the special version of SYSLIB 
called ANSLIB containing the ANSI routines, was created 
during SYSGEN part 2. Furthermore, the ARITH module in both 
SYSLIB and ANSLIB is already the correct one. 


Therefore, processing for RP, RK06, RM03 systems needs to 
ask only the following question. 


INS S$PIP 

INS SLBR 

SET /UIC=[1,1] 

* DO YOU WANT THE UTILITY TASKS TO SUPPORT ANSI MAGTAPE? [Y/N]: 


If the answer to this question is Y, the following command 
is issued to temporarily rename ANSLIB to SYSLIB, for use 
during the task-builds to come. It will later be renamed 
back to SYSLIB. As a result of this, two passes are needed 
if you are building the utilities with or without ANSI 
support. 


PIP SYSLIB.OLB/NV=ANSLIB.OLB 


Processing continues here for systems with ANSI magtape 
support, whatever the system disk is. 


REM PIP 
REM LBR 


Processing continues here for all systems whether ANSI 
Magtape support was selected or not. 


MOST OF THE TASKS TO BE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY PARTITION GEN OR 
PAR14K. GEN IS ASSUMED TO BE 40000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 

PAR14K IS A PARTITION WHICH IS 70000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 


=e se “=e we =e SS SO NO 


For a mapped system, no physical base addresses are required 
for partitions, and the corresponding two lines above are 
‘suppressed. 
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TASK FTB IS A FAST TASK BUILDER WITH LIMITED FUNCTIONALITY. 
IT DOES NOT SUPPORT OVERLAYS OR GLOBAL CROSS-REFERENCE 

BUT IT IS THREE TIME FASTER THAN BIGTKB. IT REQUIRES 

A 20K PARTITION TO RUN:IN AND IS NOT DISTRIBUTED IN TASK 
IMAGE FORM. YOU MUST BUILD IT IF YOU INTEND TO USE IT. 


THE TASK DSC IS THE DISK SAVE AND COMPRESS UTILITY. IT IS 


AS DSCSYS.SYS. IT MAY ALSO BE BUILT AS A TASK, BUT IS NOT 


ALL OF THE TASK BUILD COMMAND FILES BUILD CHECKPOINTABLE 
TASKS FOR USE WITH SYSTEMS WITH DYNAMIC ALLOCATION OF 
CHECKPOINT SPACE. IF YOUR SYSTEM DOES NOT SUPPORT 
THIS OPTION, INSTALL WILL DEFAULT THEM TO NON-CHECKPOINTABLE. 
IF YOU WISH YOU MAY BUILD TASKS WHICH ARE CHECKPOINTABLE 
AND WHICH ALLOCATE SPACE IN THEIR TASK IMAGE BY CHANGING 
THE /CP SWITCH TO THE /AL SWITCH IN THE BUILD COMMAND FILE. 
NOTE: TASKS WHICH ALLOCATE CHECKPOINT SPACE IN THEIR 


NOTE THAT THE TASKS TEC, VTEC, RNO, AND SRD ARE NOT SUPPORTED 
PRODUCTS. THEY HAVE BEEN ADDED TO THE SYSGEN3 PROCEDURE 
FOR YOUR CONVENIENCE. 

SET /UIC=[1,2x] 

INS SEDI 

* DO YOU WANT TO BUILD TASK MAC? [Y/N]: 

* DO YOU WANT TO EDIT TASK MAC'S BUILD COMMAND FILE? [Y/N] : 
EDI MACBLD.CMD 


ay eT eS ee | ee ee | eT eT ee 


DISTRIBUTED AS A STANDALONE SYSTEM ON ALL DISTRIBUTION SYSTEMS 


DISTRIBUTED IN THAT FORM. IT REQUIRES A 16K PARTITION TO RUN IN. 


TASK IMAGE REQUIRE MORE DISK SPACE THAN TASKS THAT DON'T. 


The previous three lines serve the following purposes: 


1. to decide whether to build task MAC 


2. if MAC is to be built, to edit the build 
file, if desired 


If the first question is answered with N, the two following 
lines do not appear. If the first question is answered with 
Y, and the second with N, the EDI command is not issued. 


In the following, a similar sequence is performed for 


utility task. 


* DO YOU WANT TO BUILD TASK BIGMAC? [Y/N]: 

* DO YOU WANT TO EDIT TASK BIGMAC'S BUILD COMMAND FILE? [Y/N]: 
EDI BIGMACBLD.CMD 

* DO YOU WANT TO BUILD TASK TKB? [Y/N]: 

* DO YOU WANT TO EDIT TASK TKB'S BUILD COMMAND FILE? [Y/N]: 

EDI TKBBLD.BMD 

* DO YOU WANT TO BUILD TASK BIGTKB? [Y/N]: 

* DO YOU WANT TO EDIT TASK BIGTKB'S BUILD COMMAND FILE? [Y/N]: 
EDI BIGTKBBLD.CMD 

* DO YOU WANT TO BUILD TASK PIP? [Y/N]: 

* DO YOU WANT TO EDIT TASK PIP'S BUILD COMMAND FILE? [Y/N]: 
EDI PIPBLD.CMD 

* DO YOU WANT TO BUILD TASK FLX? [Y/N]: 

* DO YOU WANT TO EDIT TASK FLX'S BUILD COMMAND FILE? [Y/N]: 
EDI FLXBLD.CMD 

* DO YOU WANT TO BUILD TASK VFY? [Y/N]: 

* DO YOU WANT TO EDIT TASK VFY'S BUILD COMMAND FILE? [Y/N]: 
EDI VFYBLD.CMD 

* DO YOU WANT TO BUILD TASK DMP? [Y/N]: 
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* DO YOU WANT TO 
EDI DMPBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI EDIBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI SLPBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
ED1 LBRBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI TECBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI VTECBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI PSEBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI SYEBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI CRFBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI ZAPBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI BADBLD.CMD 

* DO YOU WANT. TO 
* DO YOU WANT TO 
EDI VMRBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI RNOBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI SRDBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI FTBBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI CMPBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
* DO YOU WANT TO 
* DO YOU WANT TO 
EDI DSCBLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI CDABLD.CMD 

* DO YOU WANT TO 
* DO YOU WANT TO 
EDI EDTBLD.CMB 


If you 
cannot 


be built when 
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EDIT TASK DMP'S BUILD COMMAND FILE? [Y/N]: 
BUILD TASK EDI? [Y/N]: 

EDIT TASK EDI'S BUILD COMMAND FILE? [Y/N]: 
BUILD TASK SLP? [Y/N]: 

EDIT TASK SLP'S BUILD COMMAND FILE? [Y/N]: 
BUILD TASK LBR? [Y/N]: 

EDIT TASK LBR'S BUILD COMMAND FILE? [Y/N]: 
BUILD TASK TEC? [Y/N]: ; 

EDIT TASK TEC'S BUILD COMMAND FILE? [Y/N]: 


BUILD TASK VTEC? [Y/N]: 


EDIT TASK VTEC'S BUILD COMMAND FILE? [Y/N]: 


BUILD TASK PSE? [Y/N]: 


EDIT PSE'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK SYE? [Y/N]: 

EDIT SYE'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK CRF? [Y/N]: 

EDIT TASK CRF'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK ZAP? [Y/N]: 

EDIT TASK ZAP'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK BAD? [Y/N]: 

EDIT TASK BAD'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK VMR? [Y/N]: 

EDIT TASK VMR'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK RNO? [Y/N]: 

EDIT TASK RNO'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK SRD? [Y/N]: 

EDIT TASK SRD'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK FTB? [Y/N]: 

EDIT TASK FTB'S BUILD COMMAND FILE? [Y/N]: 

BUILD TAS CMP? [Y/N]: 

EDIT TASK CMP'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK PAT? [Y/N]: 

EDIT TASK PAT'S BUILD COMMAND FILE? [Y/N]: 

BUILD. TASK DSC? [Y/N]: 

EDIT TASK DSC'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK CDA? [Y/N]: 

EDIT CDA'S BUILD COMMAND FILE? [Y/N]: 

BUILD TASK EDT? [Y/N]: 

EDIT EDT'S BUILD COMMAND FILE? [Y/N]: 

are uSing the single RKO5 distribution kit, you 

build the RMS utilities. The RMS utilities can only 

using any of the other kits, hence the 

following queries, pertinent to RMS, are not displayed in 


SYSGEN 


using the single RKO5 kit. 
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* DO YOU WANT TO BUILD THE RMS UTILITIES? [Y/N]: 
If you answer affirmatively, the following queries, 
pertinent to RMS utilities, are displayed. Otherwise, they 
are omitted. 

* DO YOU WANT TO BUILD TASK RMSBCK? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSBCK'S BUILD COMMAND FILE? [Y/N]: 

EDI RMSBCKBLD.CMD 

* DO YOU WANT TO BUILD TASK RMSCNV? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSCNV'S BUILD COMMAND FILE? [Y/N]: 

EDI RMSCNVBLD.CMB 

* DO YOU WANT TO BUILD TASK RMSDEF? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSDEF'S BUILD COMMAND FILE? [Y/N]: 

EDIT RMSDEFBLD.CMD 

* DO YOU WANT TO BUILD TASK RMSDFN? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSDFN'S BUILD COMMAND FILE? [Y/N]: 

EDI RMSDFNBLD.CMD 

* DO YOU WANT TO BUILD TASK RMSDSP? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSDSP'S BUILD COMMAND FILE? [Y/N]: 

EDI RMSDSPBLD.CMD 

* DO YOU WANT TO BUILD TASK RMSRST? [Y/N]: 

* DO YOU WANT TO EDIT TASK RMSRST'S BUILD COMMAND FILE? [Y/N]: 

EDI RMSRSTBLD.CMD 

INS [1,5y]PIP 

INS [1,5y]BIGTKB 

* DO YOU WANT TO PRINT THE MAPS FOR THE UTILITY TASKS? [Y/N]: 
The maps for the utility tasks are of little use, and this 


guestion is normally 
Maps are generated. 


answered with an N, in which case no 


THE TASK MAPS WILL BE PRINTED ON 
YOUR TERMINAL 
THE LINE PRINTER 

OA LPs: 


[1 we we se Ne 


The next display is dependent upon the distribution kit you 
are uSing. 


If you are using an RLO1 distribution kit or either of the 
RKO5 distribution kits, you must make some preparations 
prior to building the utility tasks. Read the section 
pertinent to your distribution kit. 


If you are using a distribution kit other than an RLO1, 
Single RK0O5, or dual RKO5, no preparations are necessary. 


**Single RKO5 and RLO1 Kits** 


DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 

OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 

IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 

PER MEDIUM IS: 
RKO5,RLO1 AND MAGTAPE (TS03,RU10,TU16,TU45) 
FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


me =e Se SO MO MO ME NO TO 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 
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- ALL TASKS WILL FIT 
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* 
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* IS DK: 


* ENTER 


MOU DK: 


LOA DX: 


LOAD DT: 


* DO YOU 


SYSGEN DIALOGUE DETAILS 


AFTER COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
A NEW MEDIUM. IF SO THE INDIRECT FILE PROCESSOR WILL 
PAUSE TO ALLOW TIME TO MOUNT IT. 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


DK (RKO5 DISK, FOR RKO5 DISTRIBUTION KITS ONLY) 
DL (RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 
DX (RXO01 FLOPPY DISK) 

CT (TU60 CASSETTE TAPE) 

DT (TU56 DECTAPE) 

MT (TSO03, TE10, OR TU10 MAGTAPE) 

MM (TU16, TE16, OR TU45 MAGTAPE) 


ENTER DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


The next query displayed is dependent on your’ secondary 
storage device. 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK: waS entered as the secondary 
storage device. 


PUT YOUR TARGET SYSTEM DISK IN DK: 


READY? [Y/N]: 

This query is repeated until the device is ready (Y 
response). 

VOLUME LABEL OF DK: [S]: 
The device is then mounted using this volume label. 
label 
*DX: as Secondary Storage Device* 
If DX: is not loaded, the MCR LOA command is issued. 
*CT:,DT:,MT:, or MM:, as Secondary Storage* 

The following assumes DT: was entered as the secondary 
storage device. 

If the secondary storage device is not loaded, the MCR LOA 
command is isssued. 

**Dual RKO5 Kits** 

HAVE AN EMPTY RKO5 REMOVABLE DRIVE AVAILABLE? [Y/N]: 


If not, instructions are given for copying the task image 
files from secondary storage to the system disk. 


If an empty drive is available, you are asked to identify 
the unit number. 


* WHAT IS THE UNIT NUMBER OF THE EMPTY DRIVE? [0 R:0-3]: 
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The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 


=e we 


* IS THE SYSTEM DISK READY? [Y/N]: 


This question is repeated until the disk is ready 
response). When ready, the disk is mounted. 


MOU DK2:SYSTEM 
* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 


If not, the MOU command is issued again. 


NOW WE BUILD THE REQUESTED UTILITY TASKS 


o we te 


ASN LP:=MP: 
ASN TT:=MP: 
ASN NL:=MP: 
SET /UIC=[1,20] 


The selected utility tasks are now built. 


If you are using the RLO1 distribution kit or either of 


(Y 


the 


RKO5 distribution kits, the build files are copied to your 
secondary storage device and the old versions are deleted. 
Depending on your secondary storage device, either PIP or 


FLX is used to accomplish this (PIP for DL:, DK:, or DX: 
secondary storage and FLX for CT:, DT:, MM:, MT: 


as 
as 


secondary storage). The appropriate command is issued 
following the task builder directive. The following is an 
example of the display for a dual RKO5 SYSGEN using an RKO5 


(DK:) for secondary storage. 


TKB @[{1,2x] MACBLD 

PIP DK: [1,5x] /NV=[1,5x]MAC.TSK 

* WAS MAC COPIED SUCCESSFULLY? [Y/N]: 
PIP [1,5x]MAC.TSK;0/DE 


For brevity, the PIP and/or FLX commands, which appear only 
if you are using an RLO] kit or either of the RKO5 kits, are 


omitted here. 


Note that all commands are suppressed for a specific task if 
that task was not selected to be rebuilt. The following 


displays all of the tasks. 


Similar commands are issued to build each of the selected 
utility tasks. In some cases, the old versions are purged 


(PIP.../PU), leaving the most recent version, instead 


of 


being deleted (PIP.../DE). The reason for this is to keep 


tasks that may be required at later stages during SYSGEN. 


TKB @[1,2x]MACBLD 
TKB @[1,2x] BIGMACBLD 
TKB @[{1,2x]TKBBLD 
TKB @[1,2x] BIGTKBBLD 
TKB @[1,2x] PIPBLD 
TKB @[1,2x] FLXBLD 
TKB @[1,2x] VFYBLD 
TKB @[1,2x]DMPBLD 
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@[{1,2x]EDIBLD 
@[1,2x]SLPBLD 
@[{1,2x] LBRBLD 
@[1,2x] PSEBLD 
@[1,2s]SYEBLD 
@{1,2x]CRFBLD 
@[1,2x] ZAPBLD 
@{1,2x]BADBLD 
@{1,2x] VMRBLD 
@[1,2x] PATBLD 
@{1,2x]CDABLD 
@[1,2x]CMPBLD 
@[1,2x]FTBBLD 
@{1,2x]DSCBLD 
@{1,2x]RNOBLD 
@[1,2x] TECBLD 
@[1,2x]SRDBLD 
@[1,2x] EDTBLD 
@[{1,2x] RMSBCKBLD 
@[1,2x]RMSCNVBLD 
@[1,2x] RMSDEFBLD 
@[1,2x] RMSDFNBLD 
@[1,2x] RMSDSPBLD 
@[{1,2x] RMSRTIBLD 
@[1,2x] VTECBLD 


The task-builds are complete. 


If user mode diagnostics were to be built, control passes to 
the indirect command file BLDUMD.CMD (see Section x.x.x). 
The task image files that have been built (utilities and/or 
user mode diagnostics) will now be transferred to secondary 
storage. 


WE WILL PAUSE NOW TO ALLOW YOU TO COPY 


- ANY FILES THAT WERE NOT SUCCESSFULLY TRANSFERRED 
- THE DIAGNOSTIC TASKS 


WHEN THE DIAGNOSTIC TASKS HAVE BEEN COPIED, YOU 
MAY DELETE THEM FROM THIS DISK. 
WHEN DONE, RESUME AT. AS SHOWN BELOW. 


If only user mode diagnostics were selected to be built and 
no utility task, an example of how to do the transfers is 
displayed like the one below. 


(PUT A BLANK MEDIUM IN MTO0:) 

>REM PIP 

>INS [1,54] FLX;-1 

>FLX MT0:/ZE 

>FLX MTO:/DO=RK05.TSK/RS,TS03.TSK,TERM. TSK 
>RES ...AT. 


AT. -- PAUSING. TO CONTINUE TYPE "RES ...AT." 
At this time, you may manually copy any files that were not 
successfully transferred by the previous commands, and/or 
the user mode diagnostics if they were selected to be built. 

DMO DX0O: 

UNL DX0O: 
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’ 

REM FLX 
REM INI 
REM UFD 
REM PIP 


SYSGEN DIALOGUE DETAILS 


The secondary storage is dismounted and the driver unloaded. 


If you have a dual-RKO0O5 system, the task image files are now 
resident on the target system disk. Otherwise, the 
following section of text is displayed to guide you in 
transferring the task image files to the target system disk. 


TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 
STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 


SYSGEN3 HAS TERMINATED: 


If your secondary storage is DX, the following example is 
displayed (u is replaced by the actual unit number): 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[1,5x] 

>INS PIP 

>LOA DX: 


! REPEAT FROM HERE... 
>MOU DXu: TASKX ! REPLACE "TASKX" BY 
! ACTUAL VOLUME LABEL 
>PIP =DXu:*.* , 
>DMO DxXus: ! ...TO HERE FOR ALL VOLUMES 
! USED FOR TRANSFER 
>UNL DX: 
>REM PIP 


If your secondary storage is MT, MM, CT or DT, the following 
example is displayed (dd is replaced by the actual device 
mnemonic, and u is replaced by the actual unit number): 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[1,5x] 

>INS FLX 

>LOA dd: 


! REPEAT FROM HERE... 

>FLX =ddu:*.* 
1 ...TO HERE FOR ALL VOLUMES 
! USED FOR TRANSFER 

>UNL dd: 

>REM FLX 

>INS PIP;-1l 

>@MTSKCO ! MAKE TASK FILES CONTIGUOUS 
! A SERIES OF PIP COMMANDS FOLLOW 

>@ <EOF> 

>PIP MTSKCO.CMD;0/DE 

>REM PIP 


***USER MODE DIAGNOSTICS*** 


Due to space limitations and the physical locations of files 
on the RKO5 distribution kits, the user mode diagnostics are 
built in slightly differing ways. Read the section 
pertinent to your distribution kit. 
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SET /UIC=[1,20] 
**Single RKO5 and RLO1 Kits** 


NOW WE BUILD AND COPY THE TASKS TO THE SECONDARY 
STORAGE MEDIUM. 
DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 
OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 
IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 
PER MEDIUM IS: 
RKO5,RLO1 AND MAGTAPE (TS03,TU10,TU16,TU45) - ALL TASKS WILL FIT 
FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 
AFTER COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
A NEW MEDIMUM. IF SO THE INDIRECT FILE PROCESSOR WILL 

PAUSE TO ALLOW TIME TO MOUNT IT. . 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


me te MO NO “NO we BO we TSH WS ~“S WH WH ~e NO WS TO “SH WS TO WO TWH WE 


DK (RKO5 DISK, FOR RKO5 DISTRIBUTION KITS ONLY) 
DL (RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 
DX (RX01 FLOPPY DISK) 

CT (TU60 CASSETTE TAPE) 

DT (TU56 DECTAPE) 

MT (TSO3, TE10, OR TU10 MAGTAPE) 

MM (TU16, TE16, OR TU45 MAGTAPE) 


* 


ENTER DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


The next query displayed is dependent on your’ secondary 
storage device. 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK: was entered as the secondary 
storage device. 


PUT YOUR TARGET SYSTEM DISK IN DK: 


=e 


* IS DK: READY? [Y/N]: 


This query is repeated until the device is ready (Y 
response). 


* ENTER VOLUME LABEL OF DK: [S]: 
The device is then mounted using this volume label. 
MOU DK:volume label 


Control then passes to the indirect command file BLDUMD.CMD 
(see that Section). 


*DX: as Secondary Storage Device* 
If DX: is not loaded, the MCR LOA command is issued. 
LOA DX: 
TCG COPY THE TASK IMAGE FILES FROM THE SECONDARY 


STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


~e =e tO NO 
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; Z 

’ 

; (BOOT THE SYSTEM DISK) 

. >SET /UIC = [1,5x] 

; >INS SPIP 

: >LOA DX: 

; 

; !REPEAT FROM HERE... 

7 >MOU DX: TASKX ! REPLACE "TASKX" BY 

H ! ACTUAL VOLUME LABEL 

; >PIP = DX:*.* 

H >DMO DX: 

: !...TO HERE FOR ALL VOLUMES 

; {USED FOR TRANSFER 

; >UNL DX: 
Control then passes to the indirect command file BLDUMD.CMD 
(see Section x.x.x). 

*CT:, DT:, MT:, or MM: as Secondary Storage Device* 

The following assumes DT: was entered as the secondary 
storage device. 
If the secondary storage device is not loaded, the MCR LOA 
command is issued. 

LOA DT: 

TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 


me se ™O TO NO TO TO TSH NS NO NSH WS NO 


=e 


=e tO 


STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


(BOOT THE SYSTEM DISK) 
>SET /UIC = [1,5x] 
>INS S$FLX 

>LOA DT: 


! REPEAT FROM HERE... 


>FLX = DT:*.* 


! ... TO HRE FOR ALL VOLUMES 
! USED FOR TRANSFER 


>UNL DT: 


>REM FLX 


Control then passes to the indirect command file BLDUMD.CMD 
(see Section xxx). 


*kDual RKO5 Kits** 


DO YOU HAVE AN EMPTY RK0O5 REMOVABLE DRIVE AVAILABLE? [Y/N]: 


WHAT IS 


If not, instructions are given for copying the task image 
files from secondary storage to the system disk. 


If an empty drive is available, you are asked to identify 
the unit number. 


THE UNIT NUMBER OF THE EMPTY DRIVE? [O R:0-3]: 


The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 
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* IS THE SYSTEM DISK READY? [Y/N]: 


This question is repeated until the disk is ready (Y 
response). When ready, the disk is mounted. 


MOU DK2:SYSTEM 
* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 
If not, the MOUnt command is issued again. 


If mounted successfully, control passes to the indirect 
command file BLDUMD.CMD (see Section x.x.x). 


**Al11 Kits Except RLO1 Kit and RKO5 Kits** 


Control is passed directly to the indirect command file 
BLDUMD.CMD (see Section x.x.x). 


End of SYSGEN part 3. 


3.6 BLDUMD.CMD FILE DETAILS 
BLDUMD is the indirect command file to task-build all or selected User 
Mode Diagnostics. BLDUMD is called from SYSGEN part 3 if the 
corresponding question is answered appropriately. It may also be 
called manually at any time with the following command: 

>@[200,200] BLDUMD 


The following is a detailed description of all the steps in BLDUMD. 


BLDUMD <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N]: 


=e 60 SO NO Ne MO MO Ne NO tO Ne 


If the answer is N, the following text is displayed and 
BLDUMD terminates. 


SORRY, YOU CANNOT BUILD (OR RUN) THE USER MODE DIAGNOSTICS 
ON A MACHINE WITH LESS THAN 24 K WORDS! 


me =e “eo NO 


Otherwise, processing continues here. 


As in the previous sections of SYSGEN, you must identify 
your distribution kit. 


* DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 
If you do, you are asked to identify the RKO5 drives’ that 
contain the UTILOBJ and BASLINE disks. The UTILOBJ disk is 


then assigned to SY: and the BASLINE disk is assigned to 
LB:. 
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* IN WHICH RKO5 DRIVE IS THE UTILOBJ DISK MOUNTED? [0 R:0-3]: 
* IN WHICH RKO5 DRIVE IS THE BASLINE DISK MOUNTED? [0 R:0-3]: 


The following assumes DKO: for the UTILOBJ disk and DkKl1: 
for the BASLINE disk. 


ASN DKO0:=SY: 
ASN DKl1: =LB: 


If you replied negatively to the dual RKO5 query, the next 
query displayed is 


* IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/05 OR RK06? 
* DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y/N]: 
Expanded comments provide a lot of descriptive text that the 


experienced user might want to dispense with. 


DIAGNOSTIC TASKS CAN BE BUILT FOR THE FOLLOWING DEVICES: 


; MNEMONIC DEVICE DIAGNOSTIC NAME 
: DB: RJP04/RWP04 RP04 
; DB: RJPO5/RWPO05 RPO5 
3; DB: RJPO06/RWP06 RP06 
: DF: RF11/RS11 RF1l 
; DK: RK11/RK05 RKO5 
; DM: RK611/RK06 RK06 
; DP: RP11/RP02 RP02 
3; DP: RP11/RP03 RPOQ3 
3; DP: RP11E/RPRO2 RPRO2 
; DS: RJS03/RWSO03 RSO3 
; DS: RJS04/RWS04 RS04 
; DT: TC11/TU56 TU56 
> MMs TJUL6/TWUL6 TU16 
; MM: TJU16/TWU45 TU45 
; MT: TMA11/TU10 TU1O 
>; MT: TMA11/TS03 TS03 
on els TERMINAL TERM 
* 


DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 


SET UIC=[1,2x] 


If you are using other than a dual RKO5 distribution kit, 
the task image files will be generated on the system disk, 
and the next section is bypassed. 


THE DIAGNOSTIC TASKS WILL BE STORED ON THE SYSTEM DISK BY DEFAULT. 
IF YOUR SYSTEM DISK IS AN RKO5 YOU MAY BE REQUIRED TO STORE THE 
DIAGNOSTICS ON A SEPARATE DISK TO AVOID ALLOCATION PROBLEMS. 


IF YOU HAVE THE DUAL RKO5 RELEASE KIT, YOU SHOULD SPECIFY 

THAT THE DIAGNOSTICS BE STORED ON ANOTHER DISK. IF YOU HAVE 

A THIRD RKO5 PUT THE PRIVOBJ DISK IN IT AND STORE THE DIAGNOSTICS 
ON IT. OTHERWISE, STORE THEM ON LBO:. 


=e ™“e@ “Se "8 “8 SO TO TO WE 


3=1i2 


me se “0 “ee ~e Se we SO ~S8 NO NO TO 


=e ™e@ we ™O TO MO NO 


=e Se 


+ 


we we Ne MO Ne 


% 2se we NO NO NO 
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DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N]: 


If this question is answered with an N, the next section is 
bypassed. Otherwise, you are asked for the device mnemonic 
and unit number of the disk where to store the diagnostics. 


ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DKl) [S]: 


It is assumed in the following lines that you answered this 
question with DKl. 


THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DK1: 
YOU MUST CREATE THE UFD'S [1,3x] AND [1,5x] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 
DO NOT ALREADY EXIST. 


EXAMPLE: 
>INIT DK1l:DIAGNOSTICS 
>MOUNT DK1:DIAGNOSTICS 
>UFD DK1: [1,3x] 
>UFD DK1:[1,5x] 


AT. ~~ PAUSING. TO RESUME TYPE "RES ...AT." 


Whatever the system disk type is, processing continues here. 


DIAGNOSTICS ARE GENERALLY RUN WITH THE FOLLOWING ATTRIBUTES: 


PARTITION = GEN 
BASE ADDRESS = 40000 
SIZE = 40000 


The last two lines appear only if you are building 
diagnostics for an unmapped system. 


IF YOUR SYSTEM IS DIFFERENT ANSWER YES TO THE FOLLOWING QUESTION. 
DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N]: 


The following three questions are bypassed if you answered 
this question with an N. 


ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 


The following question is asked only if you are building 
diagnostics for an unmapped system. 


ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [S]: 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 


THE DIAGNOSTIC TASKS ARE NORMALLY BUILT TO TRANSFER DATA VIA 
A 2000 OCTAL BYTE DATA BUFFER. YOU MAY SPECIFY A DIFFERENT 
BUFFER SIZE BY ANSWERING THE NEXT QUESTION. 

ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 
NORMALLY DIAGNOSTIC TASK BUILD MAPS ARE NOT REQUIRED. 

IN THE UNLIKELY EVENT YOU NEED THEM, ANSWER "YES" TO THE 
FOLLOWING QUESTION. 


DO YOU WANT TASK BUILD MAPS? [Y/N]: 
DO YOU WANT THE MAPS LISTED ON THE LINEPRINTER? [Y/N]: 
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If you answered Y to the first question and N to the’ second 
of the two questions above, the maps will be directed to UFD 
[1,3x] on thé output disk. 


NORMALLY YOU ENTER EACH DIAGNOSTIC NAME REQUIRED FOR YOUR SYSTEM. 
AN ALTERNATE METHOD IS PROVIDED WHICH ALLOWS BUILDING ALL 
AVAILABLE DIAGNOSTICS. THIS METHOD REQUIRES ABOUT 500 BLOCKS OF 
DISK SPACE ON THE OUTPUT DEVICE. THE DIAGNOSTICS THAT DO NOT APPLY 
CAN BE DELETED AT A LATER TIME. 


DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 
HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N]: 


e Bwme we we MO Me Se NO 


If you answered these questions with N, processing will 
restart at the beginning of BLDUMD. Otherwise, if you want 
to build all diagnostics, the next section that asks for 
diagnostic names is bypassed. 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


THE FOLLOWING IS A LIST OF VALID DIAGNOSTIC NAMES: 
RP04,RP05,RP06,RF11,RK05,RK06,RP02,RP03,RPRO2,RS03 
RS04,TU56,TU16,TU45,TU10,TS03,TERM 


HERE IS A SAMPLE DIALOGUE TO BUILD THE RJPO4/RWP04 DISK AND THE 
TMA11/TS03 MAGTAPE DIAGNOSTICS ( <CR> = CARRIAGE RETURN) : 


NAME [S] :RP04<CR> 
NAME [S]:TSO3<CR> 
NAME [S]:<CR> 


=e =e Se MO MO ME MO NO MO ME MO MO UO UNE NO 


The next question requires as a response, the name of the 
next diagnostic to build, out of the list shown above. 


* NAME [S]: 
If an invalid name is entered (for example "XX"), the 


following message is displayed, and the question is 
repeated. 


pexeREK "XX" DIAGNOSTIC IS NOT AVAILABLE***** 
The question "* NAME [S]:" is repeated to allow you to enter 
the names of all diagnostics to be built. When done, answer 
with a single carriage return. 
If you chose to build all the diagnostics, or when you have 


entered the names of all the desired diagnostics, processing 
continues here. 


NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


e =6 @O 


gv 
INS SBIGTKB 
TKB @UMDBLD 


The command above builds the selected diagnostics, according 
to specifications defined by the previous sections. 
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REM TKB 
End of UMDBLD. 
The following sample dialogue builds diagnostics for RKO5, 
TU16, and terminals to run on an unmapped system. The GEN 
partition in that system starts at 50000. The task image 
files are directed to the target system disk which is put in 
drive DKl:. 

>@[200,200]BLDUMD 

7 . 

>; BLDUMD <VERSION 03.1> 

a 

>; COPYRIGHT (C) 1976, 1977 


>* 


DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 
BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N] :Y 

DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 

IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/06 OR RKO6? [Y/N]: Y 
DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y/N]: 
DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 


>SET /UIC=[1,20] 


>* 


DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N] :Y 
ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DK1l) [S]: DKl 


THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DK1: 
YOU MUST CREATE THE UFD'S [1,30] AND [1,50] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 


>: DO NOT ALREADY EXIST. 

>3 

AT. -- PAUSING. TO CONTINUE TYPE "RES ...AT" 

>MOU DK1:UNMOBJ 

>RES ...AT 

AT. -- CONTINUING 

> 

>* DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N] :Y 


>* 
>* 
>* 


>e 


3 
>@ 
> 


ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 

ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [S]: 50000 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 

ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 

DO YOU WANT TASK BULD MAPS? [Y/N]: 

DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 

HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N] :Y 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


NAME [S]: RKO5 
NAME [S]: TU16 
NAME [S]: TERM 
NAME [S]: 


NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


f 
>TKB @UMDBLD 


<EOF> 
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3.7 SGN ERROR MESSAGES 

The System Generation files issue a message whenever an error in the 
response to a query is detected. These messages are listed below in 
alphabetical order. Most messages apply to a number of queries. 
Those which are specific to a single query are so noted in the 
explanatory text following the message. 

Each message is preceded by *DIAG*-- 

ILLEGAL VECTOR ADDRESS 


The numeric value entered was not on a double word boundary 
(the last digit was not 0 or 4). 


Determine the correct vector address and reenter the value. 
INVALID ANSWER 


The response to the number of clock interrupts is not evenly 
divisible into 10,000(10). 


Enter a clock rate that evenly divides into 10,000(10). 
MODULE xx IS ALREADY IN USE 


The specified ICR/ICS or UDC11 module number was_ used 
previously. 


Reenter the correct module number. 

MODULES GREATER THAN 252. 
The highest module number for the UDC1il is 252(10). 
Reenter the correct module number. 

OVERLAPPING MODULES 


The ranges specified for the UDCll modules have at least one 
overlapping specification. 


Check the module range specifications and reenter’ the 
correct values. 


RSX-11M/S DOES NOT SUPPORT MIXED MASSBUS DEVICES 


Only one type of device is allowed on a_ single MASSBUS 
controller. 


Review your configuration requirements and specify only one 
device type per MASSBUS controller. 
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VECTOR ALREADY IN USE 


In the specification of vector addresses, one of the 
following conditions occured: 


@e two resident drivers have duplicate vector address values 


@® a resident driver and a loadable driver have duplicate 
vector address values 


@e a loadable driver and a resident driver have duplicate 
vector address values 


Reenter the correct vector address value. 
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GENERATING LARGER SYSTEMS 


Most of the features discussed in this chapter are intended for use in 
larger systems. However, some of the features discussed are also 
extremely useful in obtaining increased flexibility from ae_esmall 
system. Potentially useful in small systems are features such as disk 
swapping, checkpointing during terminal input, dynamic checkpoint 
space allocation, and the ACP-Executive interface. 


4.1 DEFINING MEMORY PARTITIONS 


In a 16K system, you must observe the partition boundaries defined in 
the Baseline System. Specifically, SYSPAR starts at 30100(8), and GEN 
starts at 40000(8). The two partitions DSKPAR and SECPAR are 
partitions for loadable drivers. The system disk driver resides in 
DSKPAR, and various secondary storage device drivers as well as_ the 
line printer driver are loaded into SECPAR. This configuration allows 
the SYSGEN procedure to be performed on all supported hardware 
configurations. On a 16K system, you can alter the use of the space 
dedicated to DSKPAR and SECPAR by building resident drivers instead of 
loadable drivers, but this may not be done with SYSPAR and GEN. If 
the system has more than 16K, you have the option of considering a 
different partition layout. The consequences of this flexibility 
depend on the size of the user-tailored Executive and whether’ the 
system is mapped or unmapped. 


4.1.1 Laying Out Partitions - Software Options 


Given the case of having more than 16K of memory (this usually means 
memory in at least 8K multiples), you should be aware of certain 
DIGITAL-supplied software options before laying out partitions. These 
options are described below: 


A. There are two versions of the Task Builder and MACRO-11. The 
Standard versions operate with 8K of memory. The larger 
versions (named BIGTKB and BIGMAC) require a 14K partition, 
but run considerably faster than the standard versions. In 
addition, BIGMAC supports the floating point instruction set 
and storage allocation assembler directives. BIGTKB is 
required for rebuilding the Task Builder itself. BIGMAC is 
built by the command file BIGMACBLD.CMD, and BIGTKB is built 
by the command file BIGTKBBLD.CMD. In addition, if the 
EXTEND TASK directive is generated for the target system and 
BIGMAC and BIGTKB are installed in a system controlled 
partition, both use this feature and extend themselves up to 
the limit (set by the MCR SET /MAXEXT command) to keep their 
symbol tables memory resident. If this Executive option is 
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not included, both tasks still benefit from being installed 
in partitions larger than 14K. 


The Files-ll ACP (F11ACP) is available in three versions. 
The first (FCPNMH.TSK) requires 2K of memory and does not 
support multi-header files or RMS record-locking. The second 
version (FCP.TSK) supports multi-header files and RMS but 
requires 2.5K of memory. The third version (BIGFCP.TSK) 
supports RMS and multi-header files and operates two to three 
times faster than the smaller version. The minimum size of 
BIGFCP is 4.5K plus 32 words (22100 octal); however, the 
standard task-build command file, BIGFCPBLD.CMD, specifies 
options that increase the memory requirements to 5.5K. 


MCR, FI1ACP, and TKTN share a partition in a minimum 16K 
system. If more memory is available, you should consider 
dedicating a partition to FCP. Depending on the 
characteristics of the software applications, substantial 
throughput improvements are possible. 


If large disks are being used (RP02/03/04/05/06 or RKO6) the 
system can benefit from the use of more than one file system. 
Install as many copies of FI11ACP as there are disks and mount 
each disk with its own copy by specifying the /ACP switch on 
the MOUNT command. 


When you generate a system in which MCR shares SYSPAR with 
the file system (FI11ACP), it is important that you build the 
tasks with a partition size that properly reflects the SYSPAR 
to be used. This requirement is necessary because the tasks 
are checkpointable and have checkpoint space allocated in 
their task image files. 


In a standard system where MCR and FCPNMH both reside in a 
SYSPAR that is 7700(8) bytes long, there is no problem. If, 
however, the multiheader file system FCP is used, SYSPAR must 
be increased to 10500(8) bytes. As a result, you must modify 
the MCR task-build command file to reflect the new partition 
size. 


An alternative approach on a mapped system is to define 
SYSPAR to be a system-controlled partition. Thus, MCR would 
not map to the entire partition, but only to the 7700(8) 
bytes it requires. This has the side-effect of requiring 
additional Executive dynamic memory. A PCB is’ permanently 
allocated for MCR because it always remains active; a PCB is 
allocated for FCP as long as it remains active (such as’7 when 
a device is mounted). 


NOTE 


If SYSPAR is system controlled, the shuffler task, 
SHF, must not be installed in it. 


The tasks AT., CRF, EDI, LBR, MAC, PIP, TKB, and VFY 
determine the size of the partition in which they are 
executing, and make use of any additional space for symbol 
table or additional buffer storage. Thus, they benefit from 
being installed in a partition larger than 8K. Similarly, 
BIGTKB and BIGMAC benefit if they are installed in a 
partition larger than 14K. If, during a task-build, 
assembly, or library operation, the condition of insufficient 
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dynamic memory is reported, the symbol table space must be 
expanded by using a larger partition. If these tasks are 
installed in a system-controlled partition, the amount of 
space allocated to them can be adjusted using the /INC 
keyword on the INSTALL command. If the /INC keyword is 
omitted the tasks occupy 8K; BIGMAC and BIGTKB occupy 14K. 


You can generate a multi-user system if enough memory exists 
to support more than one system task at a time. A multi-user 
system has several terminals that can be used simultaneously 
for program development or running other tasks. Given enough 
memory and a Suitable processor, RSX-11M can _ satisfactorily 
support from 2 to 24 or more users who are editing, 
compiling, task-building, debugging, and running production 
tasks. 


You can generate multi-user protection for the system. This 
feature provides protection for the system and users from 
destructive interference by others. It limits system access 
to users whose identification codes have been put into an 
account file by the system administrator. The availability 
of numerous Executive directives is limited for nonprivileged 
users, thus preventing destructive interference. 
Furthermore, certain MCR commands are absolutely privileged, 
whereas others, which are normally privileged, may be issued 
by nonprivileged users for initializing, mounting, and 
dismounting private volumes. 


You can split MCR into two cooperating tasks, MCRMU and SYS. 
MCRMU is the command dispatcher and executes only a few 
commands; SYS processes all the remaining commands normally 
provided by tthe task MCR. In addition, MCRMU initiates 
several copies of SYS as needed to process’ simultaneous 
requests from multiple terminals. 


There are a number of optional tasks that are not supplied in 
task-image format, but they add considerable usefulness to 
the system. The tasks HEL, BYE, and ACNT are required to 
support multi-user protection systems. BRO and SHUTUP 
(neither of which require multiuser resources) broadcast 
messages and shut down the system. PSE, SYE, ERL, and ERF 
are the tasks which support the error logging features of the 
Executive. MTAACP and F11iMSG supply ANSI format magtape 
support. The task SHF reallocates memory in 
system-controlled partitions when requested by the Executive. 
ACS allocates dynamic checkpoint files for the Executive. 
PRT is the print spooler that overlaps task execution with 
printing of files. These all reguire an 8K (or less) 
user-controlled partition or a system-controlled partition. 
FTB is a fast task builder which requires 20K and builds 
nonoverlaid tasks up to 3-4 times faster than BIGTKB. DSC is 
the disk save and compress utility that, in task form, 
requires 14K. 


TKTN ideally runs in a partition in which all tasks are 
either checkpointable or execute quickly. In the minimum 16K 
configuration, TKTN shares SYSPAR with MCR and FCPNMH. In 
this configuration the following situation can occur. A TAS 
command can be issued with TI: directed to the line printer. 
If the line printer is offline, TKTN cannot get into memory 
to print the device-offline message. The result is that’ the 
TAS listing does not occur, the printer-not-ready messages do 
not occur, and the pool can eventually become exhausted by 
the messages queued to TKTN. 
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One solution to this problem is simply to take care not _ to 
cause it to happen. However, if this solution is 
unreasonable and sufficient memory is available, separate 
partitions should be dedicated for TKTN and MCR. 


System tuning is application sensitive. Each installation must 
establish optimum trade-offs of hardware and software. The partition 
guidelines offered in the following sections are mainly designed to 
minimize the duration of the tuning process itself, while maintaining 
a balance with known performance and size requirements of system 
software. 


4.1.2 Partitions - User- and System-Controlled 


RSX-11M supports two kinds of partitions in which tasks can execute: 
user-controlled (or fixed) partitions, and system-controlled 
partitions. 


4.1.2.1 User-Controlled Partitions - A user-controlled (main) 
partition can be subdivided into a maximum of seven. fixed 
Subpartitions. A single task can execute in the entire partition, or 
up to seven tasks can execute simultaneously in the subpartitions. No 
tasks can execute in a Subpartition if a task is executing in the 
entire main partition. 


The main attribute of a user-controlled main partition is that only 
one task can be executing in the partition at once, regardless of 
memory requirments. This can lead to substantial waste in memory 
resources, but gives you absolute control over system activity. 


Disregarding checkpointing, the allocation of user-controlled 
partitions and the subpartitions is simple and straightforward. Tasks 
are granted residency on the basis of their priority. When a task is 
made active, it is merged into a priority-ordered queue of tasks 
waiting to gain residency in the partition. When the paritition is 
freed, the highest priority task is granted control of the partition. 


4.1.2.2 System-Controlled Partitions - System-controlled partitions 
are contiguous areas of physical memory that are managed and 
dynamically allocated to tasks by the Executive. As many tasks as 
will fit are allowed to run simultaneously in a system-controlled 
partition. Tasks are allocated a contiguous region in the partition 
and are relocated with the memory management hardware. 


Each time a task is activated to run in a system-controlled partition, 
the task is merged into a priority-ordered queue of tasks waiting to 
be loaded into the partition. To allocate the system-controlled 
partition (disregarding checkpointing), the Executive examines the 
Current state of the partition to determine whether there is enough 
contiguous space to load the highest priority task currently in the 
partition wait queue. To do this, the Executive examines a list of 
allocated areas in the partition and calculates the size of the gaps 
that exist between allocated areas. The list of allocated areas is 
ordered by physical memory address, which allows a simple computation 
of gap size. The first gap that is big enough is allocated to the 
task, and its allocation. descriptor is merged into the list of 
allocated areas. 
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If a big enough gap cannot be found, the Executive attempts to fit the 
task in the system-controlled partition by checkpointing neighboring 
tasks of lower priority. If the task cannot be brought in by 
checkpointing, then the Executive requests the shuffler task (SHF...) 
if you generated memory compaction Support for the system. 
Checkpointing and shuffling in system controlled partitions is 
discussed later in this section. Each time a task exits and frees 
memory in the partition, the Executive examines the partition wait 
queue and tries to allocate memory to the highest priority waiting 
task. 


4.1.2.3 Checkpointing - RSX-11M supports checkpointing in both user- 
and system-controlled partitions. The objective is to avoid 
preempting a lower priority task, unless a higher priority task can be 
brought in to make use of the freed memory. This optimizes the use of 
computer system resources while maintaining a priority scheduling 
discipline. 


Checkpointing in a user-controlled partition occurs under one of two 
conditions: 


1. A task requires the user-controlled main partition and is of 
a higher priority than any task currently occupying it or any 
of its subpartitions. Furthermore, all of the occupying 
tasks must be checkpointable and have checkpointing enabled. 
If all these conditions are met, all the tasks that occupy 
the partition are written onto a disk and the Executive gives 
control of the partition to the higher priority task. 


2. A task requires a subpartition of the user-controlled main 
partition, and a lower priority task occupies the main 
partition or the subpartition into which the task is to be 
loaded. Furthermore, the occupying task must be 
checkpointable and have checkpointing enabled. If all these 
conditions are met, the task that occupies the partition is 
written onto a disk and the Executive gives control of the 
subpartition to the higher priority task. 


Checkpointing in a system-controlled partition occurs as the result of 
a memory allocation failure, as described earlier. That is, the 
Executive tries to allocate a contiguous region of a system-controlled 
partition to a task and it cannot find an unoccupied memory area of 
sufficient size. In this case, the Executive reexamines the list of 
allocated areas in the partition to determine whether it can form a 
free space of sufficient size by checkpointing one or more neighboring 
tasks. As with user-controlled partitions, each task considered for 
checkpointing must be of a lower priority, it must be checkpointable, 
and it must have checkpointing enabled. 


The Executive scans the list from the beginning, looking for a_ series 
of neighboring tasks, possibly separated by gaps of free space, where 
each task satisfies the checkpoint criteria. If the aggregate sum of 
the memory occupied by such a series of tasks and free space satisfies 
the memory requirement for the higher priority task, the tasks are 
checkpointed and the higher priority task is allocated the released 
memory. If such a series of neighboring tasks cannot be found and you 
generated memory compaction for the system, the Executive calls the 
shuffler task to try to bring in the highest priority waiting task by 
compacting memory and checkpointing a sufficient number of lower 
priority tasks that are not necessarily neighbors in the partition. 
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4.1.3 Memory Compaction in a System-Controlled Partition (Shuffler) 


The shuffler's algorithm consists of two passes through the 
system-controlled partition; the steps in each pass are executed 
iteratively until the partition reaches a stable state. 


4.1.3.1 The Shuffler's First Pass - In the first pass, the shuffler 
Starts at the beginning of the system-controlled partition and tries 
to move (shuffle) all tasks that are sitting above a gap of free space 
down to the base of the free space. When possible, it also 
checkpoints any tasks that it encounters, which are waiting for 
terminal input. Task shuffling occurs in the following steps: 


l. The task is blocked from further execution and the  shuffler 
allocates the free space below the task. 


2. If necessary, the shuffler waits for the task's outstanding 
I/O count to reach zero by checking it at intervals of 
approximately one-eighth of a second. If the task I/O count 
does not drop to zero in about a half of a second, the 
shuffler marks the task's partition as having 
long-outstanding I/0, deallocates the free space below the 
task, and restarts its first-pass scan of the partition. The 
Executive clears the task's partition long-outstanding I/0 
indicator when it reduces the task's I/O count to zero. 


3. If the task's I/O count drops to zero within a half of a 
second, the shuffler moves the task down to the base of the 
free space. The speed of this move increases if the QIO 
speed optimizations were included during phase 1 of SYSGEN 
and a large BLXIO transfer vector was allocated. 


4. After the move is complete, the task is unblocked to allow 
further execution and the free space (now above the task) is 
deallocated. 


When the shuffler has completed its first pass, all free space in the 
partition has been merged into one hole at the top partition. But, 
there may be additional holes below tasks which cannot be shuffled. 


4.1.3.2 The Shuffler's Second Pass - If the shuffler completes its 
first pass and some tasks still are actively competing for memory in 
the partition, the shuffler executes its second pass algorithm. In 
the second pass, the shuffler creates an ascending, priority-ordered 
list of the tasks in the partition. It then uses this list to 
determine if the size of the waiting task is less than the sum of the 
free space in the partition and the size of one or more of the (lower 
priority) tasks that may be checkpointed. If the waiting task's size 
is less than this sum, the lower priority tasks are checkpointed. The 
shuffler then restarts its first-pass algorithm to accumulate the 
freed-up space and allocate it to the waiting task. If tasks that 
cannot be shuffled fragment the system-controlled partition, the 
second-pass algorithm is executed once for each fragment of the 
partition. 


If the shuffler completes its second pass without finding space for 
the waiting task, it searches for the next system-controlled partition 
in the system and exits if there are none. 
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When the shuffler is active but not actually executing, i.e., waiting 
for task I/O or a checkpoint operation to complete, it places itself 
in a state in which it may be checkpointed by any task. Therefore, 
the shuffler does efficiently share a partition with other tasks such 
as MCR or FI1lACP. However, for large systems the shuffler is more 
responsive when it is installed (and FIXED in memory) in a dedicated 
partition. Note that the shuffler requires less than .5K words of 
memory. The shuffler should never be installed in a system-controlled 
partition. 


RSX-11M's philosophy of checkpointing in system-controlled partitions 
avoids preempting memory unless it can actually be used. No lower 
priority task is checkpointed unless it is known beforehand that 
enough contiguous space can be made available to load the higher 
priority task. The one exception is a checkpointable task waiting for 
terminal input. It is swapped out unconditionally to make room for 
other tasks whenever the shuffler is activated. It is not brought 
back in until the terminal input request is completed. 


4.1.3.3 Unshufflable Tasks - Tasks that have been FIXED in memory can 
be shuffled. However, the following occupants of a system-controlled 
partition cannot be shuffled and cause free space to be fragmented in 
the partition. 


1. Loaded device drivers. 
2. Tasks that are connected to the ICS/ICR-11 or UDC-11l drivers. 


3. A task whose partition was previously marked by the shuffler 
as having a long-outstanding I/O and whose I/O count has yet 
to drop to zero. Typical extreme examples of this case are 
tasks that issued terminal reads and cannot be checkpointed, 
LPA11 or tasks that have synchronous functions being serviced 
by the AR11, LPS1l1, or tasks using the Connect to Interrupt 
Vector directive. 


4, Tasks that have been aborted and fixed by the Executive for a 
memory parity error. 


5. Dynamically-created common regions. 


4.1.4 Advantages of System-Controlled Partitions 


System-controlled partitions are especially useful in multi-user 
systems. By installing all the user tasks in a system-controlled 
partition, the Executive allocates space as needed. One user can be 
running an 8K task, such as PIP, while another user is running a 
larger task, such as_ BIGTKB; neither user needs a dedicated 
partition. In essence, the memory allocation of the system adapts 
itself to meet its user's requirements. 


If a system-controlled partition is the last real memory partition in 
the system (not including device partitions), the partition's size 
will be altered dynamically at bootstrap time to reflect the actual 
amount of memory from the beginning of the partition to the end of 
physical memory. 


Thus, if a system is bootstrapped on a processor having more or less 
Memory than that recorded in the system image, the partition will be 
adjusted to the proper size. As a result, a system generation is not 
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required to make use of memory that may be added to a configuration in 
the future. 


4.1.5 Unmapped System - Executive Less Than 8K 


All system tasks for an unmapped system run at specific physical 
memory addresses and must be rebuilt if they are to run elsewhere. 
The tasks distributed on the release disks fall into two classes: 


1. Those built to run at 30100(8) (SYSPAR partition) 
2. Those built to run at 40000(8) (GEN partition) 


If, after the creation of the user-tailored Executive, SSYTOP exceeds 
30100(8), but is less than 40000(8), move the SYSPAR partition to 
avoid rebuilding all of the utility tasks. As a result only the 
task-build command files for MCR, FCPNMH, and TKTN need to be edited. 
Figure 4~1 depicts a suggested layout for a 24K system where S$SYTOP 
lies between 30100(8) and 40000(8). 


One way to avoid moving SYSPAR is to generate loadable driver support 
into the system. Loadable driver support requires less than ten words 
in an unmapped Executive. However, it allows you to build a_ selected 
number of loadable drivers in partitions above GEN, reducing the size 
of the Executive. 


24K 140000(8) 
SYSPAR PARTITION 
(2K) 
22K 130000(8) 
USER 
ALLOCATABLE 
(6K) 
16K 100000(8) 
PAR14K 
PARTITION 
(14K) 
GEN 
SUBPARTITION 
(8K) 
8K 40000(8) 
EXECUTIVE 
(8K) 
0 0 


Figure 4-1 Typical Unmapped 24K System 
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Figure 4-1 shows that SYSPAR was moved from its location in the 
baseline system (refer to Figure 2-1). Moving SYSPAR requires the 
editing of the task-build command files for MCR, FCPNMH, and TKN. The 
partition PAR14K is now a real partition (rather than a pseudo 
partition, as was the case in a 16K system) and is correctly placed to 
run BIGMAC’ and BIGTKB without rebuilding them. Furthermore, because 
GEN has not been moved, tasks running in GEN do not need to _ be 
rebuilt. Finally, a 6K subpartition is available in PAR14K. You are 
free to divide this 6K memory block into any configuration of 
subpartitions that meets local requirements. 


Figure 4-2 illustrates a suggested 28K unmapped system. It is 
identical to Figure 4-1 in its allocation of the 0-24K block of 
memory. The additional 4K is allocated to main partition PMDPAR that 
PMD uses. Also, the print spooler can use a 2K subpartition, SPLPAR, 
leaving an additional 2K to suit your requirements. 


28K 160000(8) 
PMDPAR PARTITION (4K) 

SPLPAR SUBPARTITION (2K) 

24K 140000(8) 
SYSPAR PARTITION 
(2K) 

22K 130000(8) 

USER 

ALLOCATABLE 

(6K) 

16K PAR14K 100000(8) 
PARTITION 
(14K) 
GEN 
SUBPARTITION 

(8K) 

8K 40000(8) 
EXECUTIVE 
(8K) 
0 0 


Figure 4-2 Typical Unmapped 28K System 


Both of these layouts are attempts to balance SYSGEN requirements with 
known system software requirements. Local requirements may dictate an 
alternative scheme. The following system requirements for unmapped 
systems should, however, be considered: 


1. Most DIGITAL nonprivileged software requires an 8K partition. 
This software assumes that its name is GEN and that it starts 
at 40000(8). 
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2. MCR, FCPNMH, and TKN require a 2K partition. These tasks 
assume that its name is SYSPAR and that it starts at 
30100 (8). 


3. BIGTKB and BIGMAC require 14K. These tasks assume that the 
partition is named PAR14K and that it starts at 40000(8). 


Changing a starting address requires editing the task-build command 
files and rebuilding the involved tasks. 


Changing the partition's name does not require a rebuild, because the 
INSTALL command allows you to specify the partition name. However, 
the base addresses of the new partition and that for which the task 
was built must be the same. 


4.1.6 Unmapped System - Executive Greater Than 8K 


If the value of SSYTOP exceeds 40000(8) on an unmapped system, all 
privileged and nonprivileged system tasks must be rebuilt. Because 
TKB must be rebuilt with BIGTKB, a 24K system is, in general, the 
minimum system for a user-tailored Executive that exceeds 8K.* The 
layout of partitions becomes a user responsibility, limited only by 
the stated requirements for system software and application 
performance goals. Note however, that loadable driver support could 
reduce the size of the Executive to below 8K. 


4.1.7 Mapped Systems 


The minimum memory size for a mapped system is 24K. You need not 
rebuild nonprivileged tasks in a mapped system when physical partition 
boundaries move. This is true because nonprivileged tasks on a mapped 
system run at a virtual base address of zero, rather than at a 
physical base address. Thus, the value of S$SYTOP is much less 
critical in a mapped system. 


You must always rebuild privileged tasks, as with an unmapped system, 
because they are linked to the Executive symbol table file. You must 
rebuild nonprivileged tasks only if you change any of the task's 
attributes such as_ checkpointability. The Task Builder establishes 
the attributes when building a task. Consult the RSX-11M Task Builder 
Reference Manual for a comprehensive discussion of task attributes and 
associated Task Builder switches. 


4.1.8 Example of a Large Mapped System 


To realize the highest throughput for a large mapped system, there are 
a number of configuration options which must be considered. The 
example addresses a system with the following hardware: 


PDP~11/45 with 124K of memory 
2 RSO4 fixed head disks 

2 RKO5 disks 

2 RP06 disks 


* New systems exist in multiples of 8K, 16K, and 32K memory stacks. 
Existing systems of 20K could support a user-tailored Executive which 
exceeded 8K. 


GENERATING LARGER SYSTEMS 


TU16 magtape drives 

TU56 DECtape drives 

DH11 with 4 remote lines and 12 local lines 
LP1ll printer 

DL11-A line interface 


MPReENN 


The following partition layout may be used 


760000 
=) 210000 

SPLPAR 

200000 
FCPPAR 

150000 
SYSPAR 

140000 
DRVPAR 

120000 
EXEC + 

DYNAMIC STORAGE 

REGION 

0 


DRVPAR is a 4K, system-controlled partition for loadable drivers; 
this is sufficient for loading all of the device drivers including the 
terminal driver. SYSPAR is a 2K partition for MCRMU, TKTN, and_ the 
shuffler. FCPPAR is a 6K partition for the primary BIGFCP; this is 
sufficient to allocate approximately 50 file control blocks (FCBs). 
SPLPAR is a 2K partition for the print spooler. All other tasks run 
in the system-controlled GEN partition. For increased throughput, a 
second copy of BIGFCP is installed in GEN to service the second RPO6. 
In addition to providing overlapped operations, this allows FCBs_ for 
files accessed on the second RP06 to be stored in the second task 
image. A third version of the file system should be built and 
installed with the name DTAACP if you want Files-ll DECtape 
processing. This version should be the 2K, non-multiheader FCPNMH. 


Primary checkpoint space of 1024 blocks is allocated on an _ RS04 
fixed-head disk and secondary space of 2048 blocks is allocated on the 
first RPO6. Under control of the startup file [1,2]STARTUP.CMD, all 
utility tasks (e.g., BIGMAC, BIGTKB, PIP, EDI, SLP etc.) are copied to 
an RSO4 and the work files for BIGTKB, BIGMAC, and CRF (LUN 8) are 
assigned to the second RS04. This increases system throughput by 
providing faster overlay and work file processing. 


4.2 BUILDING SYSTEMS FOR RESIDENCE ON OTHER DEVICES 


An RSX-11M system can reside on any file-structured device. Thus, in 
addition to the RKO5, RPO02, RPO3, RPO4, RP05, RPO6, and RKO6 disks, 
the system may reside on the RF11, RSO3/RS04, or RX01 disks, or on 
DECtape. Because the system, including all privileged and 
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nonprivileged tasks, requires approximately 2200 blocks of storage, 
use of the alternate devices requires careful examination and 
planning. 


It is fairly easy to put a system on another device. The steps are: 
1. Format the disk, if necessary. 
2. Initialize the disk as a Files-1ll volume. 
3. Mount the disk and establish the following directories on it: 
{1,1}, [1,2], [1,4], [1,6], and [1,50] or [1,54] 


4. Transfer all files in [1,1],[1,2], and [1,50] or [1,54] from 
the system disk to the target device, as shown below: 


>SET /UIC=[1,1] 

>PIP DSO:=DKO:*.* 

>PIP DSO: [1,2]=DKO:[1,2]*.* 
>PIP DSO: [1,50]=DK0:[1,50]*.* 


5. If the Executive in the system image file RSX11M.SYS, 
contains installed tasks, create a new system image file by 
copying the Executive task image contained in RSX11M.TSK. 
(Thus, in SYSGEN2 you should specify that the Executive 
backup file be retained.) Follow the procedure used in 
SYSGEN2 to ensure that the resulting file is contiguous and 
is sufficiently long. 


NOTE 


The target system Executive must include 
Support for the device on which it is to 
reside; otherwise the device driver 
will not be available to load tasks. 


6. Using the MCR ASN command, create the logical device names 
LB: and SY: and assign them to the target disk, as follows: 


>ASN DSO:=SY: 
>ASN DSO:=LB: 


7. Run VMR to set up the partitions and install the required 
tasks. Note that all tasks must be installed from device 
LB:. 


8. Bootstrap the new system and save it with the /WB switch to 
rewrite the bootstrap block. 


>BOO DS: [1,50] 


RSX-11M V03.1 BL22 
>SAV /WB 


4.3 SUPPORTING MORE THAN ONE SYSTEM ON THE SAME VOLUME 


Supporting more than one system on the same device is. fairly 
straightforward. Create a separate directory for the new system, such 
as [2,50] or [2,54]. 
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1. Copy (or rename) all files from [1,50] or [1,54] to the new 
directory. Note that tasks may not be installed in two 
systems at the same time; therefore, all tasks to be 
installed concurrently in both systems must have separate 
task images. 

2. Create the file RSX11M.SYS from the RSX11M.TSK file. 

3. Run VMR, set up partitions, and install tasks. 

4. Bootstrap the system and save it (specifying the /WB- switch 
to write a new bootstrap block, if desired). 

There are now two systems on the same volume. If the 


install-run-and-remove option of the RUN command is to work properly, 
the default UIC for the task image (specified by $ in RUN $xxx) must 


be set 


up for the proper UIC. This may be done with the SET /SYSUIC 


command as in SET /SYSUIC=[2,54]. 


EXAMPLE: 


>UFD SY: [2,54] 

>SET /UIC=[2,54] 

>PIP =[1,54] 

>PIP RSX11M.SYS;*/DE 

>PIP RSX11M.SYS=RSX11M.TSK 
>VMR 

ENTER FILENAME: RSX11M 

VMR>SET /POOL=400 

VMR>SET /MAIN=SYSPAR: 400:100:TASK 
VMR>SET /MAIN=GEN:500:1100:SYS 
VMR>INS FCP 

VMR>INS INS 

VMR>INS MCR 

VMR>INS MOU 

VMR>INS SAV 

VMR>”Z 

>BOO 


RSX11M V03.1 BL22 
>SET /SYSUIC=[2,54] 
>SAV 


RSX11M V03.1 BL22 64K MAPPED 
>RED DK0O:=LBO: 

>RED DKO:=SY0: 

>MOU DKO:SYSTEM 

>@[{1,2] STARTUP 

>@<EOF> 


If disk space is limited, you may alter step 1 above to include only 
those tasks that are to be statically installed in one or both 


systems. 


Typically this means that only one . copy of each 


nonprivileged user task is maintained. These utility tasks may then 
either be installed by the STARTUP file or always initiated using RUN 
SXXX. In this case, if Executives are identical, or no drivers are to 
be loaded on-line, the system UIC should be the same for both systems. 
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4.4 INCREASING FILE SYSTEM THROUGHPUT 


4.4.1 Building a Faster File System 


As distributed, the SYSGEN command files build a 2K, 2.5K, or 5.5K 
file system. The 5.5K file system is two to three times faster than 
the smaller versions for certain operations. However, increased speed 
in directory operations is possible by increasing the number of 
directory blocks read in at one time. This may become important on 
large disks, such as the RP02, RP03, RPO04, RPO5, RPO6, RMO3, and RKO6. 


To increase or decrease the number of directory blocks read in at one 
time, you must edit the file BIGFCPBLD.CMD. The size of BIGFCP can be 
reduced to 5K by eliminating the additional buffers allocated to 
directory blocks, or it may be increased by .25K for each additional 
block. The program section containing the extended directory buffers 
is S$S$BUF3. To reduce the size of BIGFCP to 5K, delete the line: 


EXTSCT=$SBUF3: 2000 


To increase the number of blocks read, edit the line to increase the 
PSECT by the number of additional bytes to be read. Keep in mind that 
directory blocks are read in multiples of 1000(8) bytes; thus, the 
PSECT should be altered only by increments of 1000(8). For example, 
the statement: 


EXTSCT=S$SBUF3:5000 


allocates buffer space for five additional blocks permitting up to six 
directory blocks to be read at a time. 


NOTE 


The file system task should not share a 
user-partition with any task that 
performs file-structured I/O. Any other 
configuration will cause a malfunction 
of the RSX-11M system. The operation of 
RSX-11M is heavily dependent on the file 
system. Nearly all tasks request 
processing from it. Thus, for a system 
to operate properly, the file system 
must be in a partition where it can 
react promptly. Most tasks request an 
I/O operation through F11ACP, and while 
this I/O operation is in progress, the 
tasks cannot be checkpointed. Thus, if 
F1LIACP is running in the same partition, 
it may not be loaded into memory to 
process the request. 


4.4.2 File Control Primitives Dynamic Memory Requirements 


4.4.2.1 Directory Least-Recently-Used List - A special feature of the 
file control primitive (FI11ACP) task improves’ the performance of 
directory operations. However, as many as 54 (decimal) words of 
dynamic memory may be required for each mounted volume. 
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This feature allows directories to be pre-accessed, as follows: the 
first time a directory operation is performed on a given directory 
(master file directory or user file directory), the directory is 
accessed. An 18-word file control block (FCB) is stored in the 
directory least-recently~-used (LRU) list. The LRU list is actually a 
thread through the FCB list pointed to by the volume control block. 


Pre-accessing directories in this way generally saves three disk 
accesses for every directory operation. The search of the master file 
directory for the identification of the user file directory is 
bypassed completely, thus eliminating the read of the MFD file header 
and MFD data _ block. Pre-accessing the user file directory also 
eliminates reading the UFD's file header. 


The dynamic memory needed to include this time saving feature may be 
intolerable for users with limited dynamic memory, because up to three 
18-word LRU entries may be required for each mounted volume. The 
maximum number of directory LRU-list entries that FCP uses is set when 
the volume is initialized by the /LRU keyword; the default is 3. The 
LRU value can be overridden when the volume is mounted. 


4.4.2.2 File Control Block Allocation - For each open file in the 
system, a 50(8) byte File Control Block (FCB) is required. The file 
system uses this control block to maintain critical information about 
the file. In the 2K FCPNMH and 2.5K FCP, FCBs are allocated from the 
Executive's dynamic storage region. However, in the 5.5K BIGFCP, FCBs 
may be allocated from space within FCP's partition before overflowing 
into the dynamic storage region. PSECT SSFRE]1 controls the amount of 
memory allocated to FCBs, which is extended in the build command file 
BIGFCPBLD.CMD. This feature is especially important for large, 
multi-user systems because it reduces the load on the dynamic storage 
region. 


4.4.3 Multiple File Systems 


For systems with several high-performance disks it is possible to 
increase file system throughput by mounting each volume with a 
separate Fl1ACP. This allows a separate pool of FCBs for each disk 
volume (in each F11ACP partition), and allows overlapping of directory 
reguests on each volume. 


If Files-1l support for DECtape is desired, a separate FI11lACP should 
be installed with the name DTAACP, the primary default file system ACP 
for mounted DECtapes. This version of F11ACP should be the smallest 
(2K) file system that does not support multi-header files 
(FCPNMH.TSK) . 


4.5 INSTALLING AND USING RESIDENT LIBRARIES AND COMMON BLOCKS 


RSX-11M supports resident libraries and common blocks which may be 
shared by several tasks. Resident libraries and common blocks must be 
installed in common partitions. 
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4.5.1 Setting up a Common Partition 


Establish a common partition by using the MCR SET command specifying 
the partition type COM. For example, the following command: 


>SET /MAIN=FORRES: 1000: 300:COM 


sets up a main common partition named FORRES, starting at 100000, that 
is 30000 bytes long. 


To eliminate a common partition, use the SET /NOMAIN or SET /NOSUB 
command. 


4.5.2 Installing a Library or Common Block 


Both the task and symbol table files (.TSK and .STB) must be_- stored 
under UIC [1,1] on device LB:. Tasks using the common block or 
resident library must specify its name during task-build. You must 
install the common block or library before you install a task 
referencing the library or common block. This is done with the MCR 
INSTALL command, as shown below: 


>INS [1,1] FORRES/PAR=FORRES 


This command causes the library or common block to be loaded into the 
partition. Note that this is special case processing by Install. 
Normally, Install only creates Task Control Blocks (TCBs) for tasks 
without reading executable code. For a common block or library, the 
common block or library is read into memory. You can then install 
tasks that reference the library or common block. 


4.5.3 Eliminating a Library or Common Block 


You can eliminate a common block or library only by using the MCR’ SET 
command. For example, the command: 


>SET /NOMAIN=FORRES 


eliminates the library FORRES (installed as shown in Section 4.5.2) 
and the partition FORRES. Use care when eliminating a library or 
common block to remove any tasks that reference it before eliminating 
the library. 


4.6 BUILDING A FORTRAN OTS RESIDENT LIBRARY 


To save memory space, you may want to build a resident (sharable) 
library containing frequently-used FORTRAN routines. 


A MACRO~-11 source file that aids you in building a resident FORTRAN 
library is distributed with RSX-11M. This file, named FORRES.MAC, is 
under UIC [200,200] on the system disk (on the RKO5 kits, the mapped 
and unmapped object disks). As distributed, this module generates an 
8K library for a system with no extended arithmetic support. 


While it is not necessary to build the resident library during system 
generation, memory space for it should be considered at that time. 
Otherwise, it may be difficult to install the library. 
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Building an optimal resident library is an iterative process. The 
file FORRES.MAC must be edited with consideration for size and program 
requirements. 


For most efficient use of virtual memory, the library should be as 
close as possible to a 4K boundary, without exceeding that boundary. 


The following steps are a guide to tailoring the FORTRAN library to 
individual system requirements. This process assumes that a system 
generation has already been done, that all tasks are installed, and 
that the system has been saved. 


l. For easy reference to the MACRO-l1l file, a listing of 
FORRES.MAC may be useful: 


>SET /UIC=[200, 200] 
>PIP LP:=FORRES.MAC 


2. Edit the MACRO-11 file to insert or remove entry points as 
needed. 


3. Assemble the MACRO-11 file: 
>MAC FORRES, LP: =FORRES 


4. Task-build the object file, specifying the /-HD and /-PI 
Switches on the symbol table file. The only Task Builder 
option required is STACK=0. The appropriate command sequence 
is shown below: 


TKB>, LP: ,SY: FORRES/-HD/-PI=FORRES 
TKB>/ 

ENTER OPTIONS: 

TKB>STACK=0 

TKB>// 


5. Examine the Task Builder map to obtain the size of the 
library (in octal bytes), as shown in the line R/W MEM 
LIMITS:. If the library does not fit into the partition 
planned for it, examine the rest of the map to obtain the 
Sizes of individual modules. Remember that the library 
should be as close as _ possible to a 4K boundary, without 
exceeding that boundary. 


If the size of the library is not correct, repeat steps 2 
through 5. 


6. When the library is the desired size, task-build it in UIC 
[1,1], specifying all output files. In addition to the STACK 
option, you must use the PAR option, as shown below: 


>SET /UIC=[1,1] 

>TKB 

TKB>FORRES, LP: ,SY: FORRES/-HD/-PI=[200, 200] FORRES 
TKB>/ 

ENTER OPTIONS: 

TKB>STACK=0 

TKB>PAR=FORRES:base:length 

TKB>// 


The base address for FORRES should be set as high as possible 
for a mapped system. (For example, if the size of the 
library is greater than 4K but less than 8K, the base address 
should be set to 140000.) For an unmapped system, it is the 
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actual common block base address. The size of the partition 
May be assumed to be _ 8K. After one task-build, a more 
accurate size can be given. 


(If there is a FCS resident library available, the TKB option 
LIBR=FCSRES:RO may also be used.) 


7. Allocate space for the library, as shown below: 
>SET /MAIN=FORRES:base:length:COM 

8. Install the library using the following command: 
>INS FORRES 


9. Now perform a SAVE, or edit the [1,2] STARTUP.CMD command 
file to install FORRES when the system is bootstrapped. 


4.7 BUILDING AN FCS (POSITION-INDEPENDENT) RESIDENT LIBRARY 


To save memory, you may want to produce a position~-independent library 
containing all the FCS modules required by a set of programs that are 
intended to run simultaneously. 


The MACRO-11 source file, [200,200] FCSRES.MAC, aids you in building 
an FCS resident library. As distributed, this file produces a 4K 
library and contains every module in FCS. If you want to produce a 
smaller version of FCSRES you must edit the FCSRES.MAC file, 
eliminating the .GLOBL references for those modules to be excluded. 


It should be understood that the number of FCS modules that are 
included in a resident library is dependent upon the applications that 
require the FCS library. An essential point to consider is that a 
task that links to FCSRES cannot include missing FCS modules from the 
system object library, SYSLIB.OLB. Such a program cannot link with 
FCSRES; it must instead link all of FCS from SYSLIB. 


To build FCSRES: 
1. Edit the FCSRES.MAC file, if desired. 
2. Assemble it, as shown below: 
MAC>FCSRES, LP: =FCSRES 
3. Task-build it with the following command sequence: 


>SET /UIC=[1,1] 

>TKB 

TKB>FCSRES/-HD/PI,LP: ,SY:FCSRES=[200,200]FCSRES 
TKB>/ 

ENTER OPTIONS: 

TKB>STACK=0 

TKB>PAR=FCSRES:base:size 

TKB>// 


The base address for FCSRES is always 0 for a mapped system. 
For an unmapped system, it is the actual common block base 
address. The size of the partition may be assumed to be 4K. 
After one task-build, a more accurate size can be given. 
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4. Allocate space for the library, as shown below: 
>SET /MAIN=FCSRES:1400:200:COM 


This example creates a 4K common block (library) at physical 
address 140000. 


5. Install the library using the following command: 
>INS [1,1] FCSRES 


6. Save the system or edit the [1,2] STARTUP.CMD command file to 
install FCSRES when the system is bootstrapped. 


If a FORTRAN resident library is required in conjunction with an _ FCS 
resident library, first build FCSRES, then include the Task Builder 
option statement 


LIBR=FCSRES: RO 


in the task-build options for FORRES. This results in a considerably 
smaller FORRES. By properly tailoring the FORTRAN resident library, a 
flexible 4K FORRES usSing a 4K FCSRES can be built. In addition, this 
allows the use of FCSRES by itself when FORRES is not required. 


4.8 PRINT SPOOLER (PRT) 


A print spooler (PRT) task is provided that you can build to print 
listings simultaneously with the operation of other tasks. The 
MACRO-11 assembler, Task Builder, and FORTRAN compilers try to _ spool 
all listing or map files generated by them onto disk. If the print 
spooler is not installed, the files remain on disk. If the spooler is 
installed, it is started, thus printing any files in its receive list 
(input queue). Using the print spooler speeds up the operation of 
MACRO-11, the Task Builder, and compilers, because they do not have to 
wait for I/O to complete on the relatively slow (compared to _ disk) 
line printer. 


For optimum operation, the print spooler should be installed in its 
own 2K partition. It may be built checkpointable or not 
checkpointable. 


Under normal circumstances the spooler deletes only a small class of 
files after printing. However, it is possible for you to build a 
deleting print spooler. Do this by editing the task-build command 
file PRTBLD.CMD during SYSGEN phase 2. When the line text editor 
(EDI) prompts, enter the following commands: 


*F GBLPAT=PRT: $DELET 
GBLPAT=PRT: $DELET: 0 
*C/071 

GBLPAT=PRT: SDELET: 1 
*EX 


The spooler built without this patch deletes only the following files: 
*.PMD, *.DMP, LP.LST, and LP.MAP. 


You may supply an alternative file deletion algorithm and include it 
in task PRT. The module should define the global entry point SDELCK. 
The routine is called with register RO containing the FDB of the file 
just printed. On return, RO must be preserved and the processor 
status C-bit should be set to indicate that the file is to be deleted. 
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Use of this feature bypasses all of PRT's default file deletion logic. 
To include this module, insert it in the object library PRT.OLB, and 
edit the task-build command file PRTBLD.CMD, deleting the following 
line: 


GBLDEF=$DELCK: 0 


Before a file is printed, an identification page is generated. This 
page contains the RSX-11M version number; the date and time; and the 
device, UFD, and name of the file being printed. In addition, the 
file name is printed in large block letters for readability. Two 
formats are available, a large one for 132-column printers, and a 
smaller one for 80-column printers. 


You may build PRT to omit the file identification page by modifying a 
global patch in the task-build command file as follows: 


*F GBLPAT=PRT: SFLAG 
GBLPAT=PRT:S$FLAG: 1 
*C/1/0/ 
GBLPAT=PRT:SFLAG: 0 


Note that the value specified in the GBLPAT statement is used to 
determine the number of title pages printed. There are additional 
options for specifying flag page size and the number of trailing form 
feed characters to be printed. The task-build command file, 
PRTBLD.CMD, contains detailed commentary concerning these options. 


4.9 BUILDING MULTI-USER SYSTEMS 


RSX-11M can support more than one terminal that is running’ tasks. 
Such systems are called multi-user systems. Depending on the 
processor, disks, memory size, and job mix, RSX-11M can support from 2 
to 24 or more users simultaneously. 


4.9.1 Setting Up a Multi-User System 


At system generation, more than one terminal should be generated for 
the system. These terminals may consist of any combination of DLlls, 
DJlls, DHlls, or DZlls. DH11ls and DZlls may have both local and 
remote lines. 


The system manager has the choice of defining fixed partitions or 
system-controlled partitions. Support for system-controlled 
partitions must be included in the Executive during system generation. 
In a fixed partition system, each user terminal is allocated a 
dedicated partition in which to run its tasks; all tasks for that 
terminal must be installed to run in that partition. In a 
system-controlled partition, the Executive allocates memory to user 
tasks, aS required; all tasks regardless of terminal association may 
be installed in the same partition. This scheme is much more flexible 
than a fixed partition scheme, because only the space needed for the 
current task mix is used. In a fixed partition system, much space 
could be wasted if partitions are made big enough to run tasks such as 
BIGTKB and BIGMAC; most work is done using smaller tasks such as’ EDI 
or PIP. 
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4.9.2 Installing Checkpointable Tasks 


4.9.2.1 Systems. without Dynamic Allocation of Checkpoint . Space - A 
single task image may be installed any number of times if it is not 
checkpointable. If the task is checkpointable it can be installed 
only once because it must checkpoint into the space allocated in its 
task image file. To install many copies of checkpointable tasks in 
this system, there must be a corresponding number of task image files. 


Checkpointable MCR task image files should be copied and named 
according to the following conventions. The first three characters of 
the task name should be the MCR command name that invokes’ the task. 
This should be suffixed with the letter T and the unit number of the 
terminal from which the copy of the task is invoked. The tasks can 
then be installed with task names constructed in the same manner. 


For example, assume the MACRO-1ll assembler (MAC) is checkpointable, 
and copies of its task image file must be made to allow more than one 
user to run it. In such a case, there should be MACTO.TSK, 
MACT1.TSK,...,MACTn.TSK, where the Tn suffix corresponds to a terminal 
number. Then, the file MACTO.TSK should be installed as task 
MACTO, MACT1.TSK as MACT1, and MACTn.TSK should be installed as task 
MACTn. 


4.9.2.2 Systems with Dynamic Allocation of Checkpoint Space - On 
systems with dynamic allocation of checkpoint space and 
system-controlled partitions, only one copy of an MCR task needs to be 
installed. The system automatically spawns additional copies of the 
tasks as needed, and they are checkpointed on demand to the checkpoint 
file. The spawned tasks are named as described in the previous 
section. 


If the system has only fixed partitions, an MCR task must be installed 
once for each partition (terminal) using the naming conventions 
discussed earlier. However, only a single copy of the task image file 
is required. 


4.9.3 Installing Noncheckpointable Tasks 


4.9.3.1 Fixed Partition Systems - For fixed partition systems, all 
MCR tasks should be installed for each partition (terminal) using the 
naming conventions discussed earlier. However, only a single copy of 
the task image file is required. 


For tasks that are activated by the install-run-and-remove option of 
the RUN command, the task INS should be installed in each dedicated 
terminal partition. Tasks started by the install-run-and-remove 
command are named TTn, where’ n is the unit number of the terminal from 
which it was started. The task runs in the partition in which the 
task INSTn was running. The partition and naming conventions may be 
overridden by explicitly including the task and partition name in the 
RUN command. 
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4.9.3.2 System-Controlled Partitions - For multi-user systems with a 
system-controlled partition, the Executive names and creates tasks. 
Only one copy of each task needs to be installed in the 
system-controlled partition. The default name should be that used in 
single-user systems (e.g., MACRO-ll is ...MAC). 


4.9.4 Task Invocation 


When you type the command to invoke an MCR task (e.g., >MAC A,A=B), 
the system executes the following algorithm, where XXX is the command 
name: 


l. Search for ...XXX in the list of installed tasks. If found 
and not active, start it, and assign TI: to the terminal 
which issued the command. 


Otherwise: 

2. Search for XXXTn in the list of installed tasks. If found 
and not active, start it, and assign TI: to the terminal 
which issued the command. 

If XXXTn is active, issue TASK ACTIVE message. 
Otherwise: 

3. If task XXXTn was not found, and task ...XXX was found but 

was active, and if task ...XXX is installed in a 


system-controlled partition, then duplicate the task control 
block entry for task ...XXX, name the task XXXTn, start it, 


and assign TI: to the invoking terminal. On task exit, 
deallocate the temporary task control block entry for the 
XXXTn. 


4. If both tasks ...XXX and XXXTn were not found, issue TASK NOT 
IN SYSTEM message. 


For the install-run-and-remove option of the RUN command, the task is 
always named TTn, where n is the unit number of the terminal from 
which it was requested. It is installed in the partition that task 
INS is running in, unless overridden by the /PAR= option. 


4.9.5 Disk Swapping 


Disk swapping allows more tasks of equal (or close) priority to § share 
an amount of memory into which they cannot be loaded simultaneously. 
Swapping is accomplished by varying task priorities so that tasks of 
Similar priorities checkpoint each other periodically. Swapping is 
Supported in both mapped and unmapped systems, and in user- and 
system-controlled partitions; the only required Executive feature is 
checkpointing. Swapping costs very little in terms of Executive (size 
and time) overhead. The disk requirements of a swapping system can be 
greatly reduced by the inclusion of dynamic checkpoint space 
allocation in the Executive. : 


Swapping does not affect the basic checkpointing algorithm as 
described earlier. For .example, a task can only checkpoint another 
task of lower priority, never one of equal or higher priority. 
However, when swapping is enabled, the priority of tasks resident in 
memory, with respect only to the allocation of memory, varies with 
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time. The task's priority with respect to all of the other system 
resources DOES NOT CHANGE. 


There are two SYSGEN parameters that control the swapping algorithm. 


1. Swapping interval. This parameter determines how often the 
Executive scans the partition lists to modify the memory 
priority of resident tasks. A typical swapping interval 
might be about a half of a second. 


2. Swapping priority range. ‘This is the absolute value of the 
range through which a task's priority varies from its 
installed priority. A typical value is 5. This value would 
cause a task's memory priority to vary from P+5 to P-5, where 
P is the priority set for the task when it was installed. 


The key element of the swapping algorithm is a byte in the task's 
header in which the swapping priority of the task is maintained. The 
symbol SSSWPR is equated to the swapping priority range specified 
during SYSGEN. In a swapping system, the Executive determines whether 
a nonresident task should checkpoint a resident task by comparing the 
running priority of the nonresident task with the sum of the running 
and swapping priorities of the resident task. Each time a task is 
read into memory as the result of an initial task load or checkpoint 
read, the swapping priority byte in the task header is initialized to 
+SSSWPR. On the occurrence of each swapping interval, the swapping 
priority of each resident task is reduced by one until it reaches 
-SSSWPR. If there is a possibility that checkpointing within a main 
partition might occur based on the new priorities, the Executive 
executes its partition allocation algorithm for that main paritition. 


When specifying the swapping parameters, consider the following hints. 


l. From the time a task is loaded into memory, the average time 
it takes for it to be checkpointed by a task of the same 
running priority is roughly equal to the product of the two 
Swapping parameters. 


2. Tasks of the same running priority tend to get the same 
amount of time in memory. Tasks whose running priorities 
differ by less than the swapping priority range tend to 
receive different amounts of time in memory with the higher 
priority tasks getting more time. 


3. Ina system that supports checkpointing during terminal 
input, terminal input is also a factor in causing 
checkpointing to occur. Editors and other interactive tasks 
normally should run at a higher priority than more 
compute-bound tasks. However, when an editor is waiting for 
terminal input, it can be checkpointed by any lower priority 
task. As soon as its input is complete, the editor can come 
back into memory by checkpointing the lower priority task. 
It is possible in a highly interactive system, that the 
naturally high checkpoint rate reduces the need for the 
Executive swapping code to service many tasks of equal 
priority. 


4.9.6 Round-Robin Scheduler 


You can include an optional round-robin scheduler in the Executive. 
This scheduler time-slices the CPU among tasks in a specified priority 
range. It ensures that all tasks of equal priority share the CPU. 
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Round-robin scheduling does not affect the standard processor 
competition by tasks of different priorities. It also does not affect 
tasks that are not in the specified priority range. 


The round-robin scheduler affects only those tasks in memory (tasks 
that are on the Active Task List). Tasks that are checkpointed or in 
the partition wait queue are not affected. 


4.9.7 Checkpointing During Terminal Input. Wait 


You can select an Executive SYSGEN option that allows tasks that are 
checkpointable to be displaced from memory while they are waiting for 
terminal input. This feature allows more copies of terminal I/O-bound 
tasks (e.g., EDI) to be run than normally could be run in a given 
amount of memory. 


When the terminal driver dequeves a terminal input request for a 
checkpointable task that has checkpointing enabled, is not at AST 
state, and has ASTs enabled, the task is stopped from further 
execution. Thus, even if the task has not entered a wait state for 
the terminal input, its execution immediately stops when the request 
is dequeued by the terminal driver. 


Normally, a task that has been checkpointed for terminal input is not 
brought back into memory until its terminal request has_ been 
satisfied. This is true even if memory becomes available during the 
wait. The only way the task can execute further, prior to the 
completion of the terminal input, is to receive an AST. 


When a task is stopped in this manner, its effective priority within 
its partition drops to zero. (Its actual priority never changes.) 
Therefore, lower priority tasks ready to run can cause a higher 
priority task that is waiting for terminal input to be checkpointed. 
When the terminal input to the checkpointed higher-priority task 
completes, the Executive removes the stop condition and the task can 
be brought back into memory. If necessary, the Executive displaces 
lower priority checkpointable tasks to make room for it. 


4.9.8 Dynamic Checkpoint Space Allocation and Task Extension 


Memory usage can be improved in large multi-user systems by making all 
or most of the tasks in the system checkpointable. In doing so, the 
system disk requirements can be greatly reduced if the system includes 
dynamic checkpoint space allocation. With this feature, all task 
checkpointing operations use common system checkpoint files. Thus, 
tasks can be installed as checkpointable without having to allocate 
checkpoint space in the task image file. Furthermore, multiple copies 
of a checkpointable task can be run from a single task image. Coupled 
with task checkpointing during terminal input, the number of tasks 
that absolutely require memory residency can be reduced sharply. 


System checkpoint files are established and eliminated with the MCR 
ACS command. One checkpoint file may be established for each mounted 
Files-ll volume. When the Executive requires checkpoint space, it 
favors the devices in the allocation order of the checkpoint files. 
Therefore, if multiple ACS commands are issued, the fastest devices 
should be specified first. 


For example, a system may have both an RSO04 fixed-head disk, and an 
RP06 movable-head disk. The system manager may determine that limited 
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checkpoint space (200 blocks) can be allocated on the RS04. To ensure 
that checkpoint allocation failures never occur, additional space 
(1200 blocks) should be allocated on the RPO6. The startup command 
file would then contain the following two lines: 


ACS DS:/BLKS=200. !ALLOCATE PRIMARY CHECKPOINT FILE. 
ACS DB:/BLKS=1200. !ALLOCATE SECONDARY CHECKPOINT FILE. 


As the Executive allocates and deallocates checkpoint space, the 
checkpoint files can fill up and become fragmented. When possible, 
freed-up checkpoint space is reused. However, depending on the sizes 
of the checkpoint files and the amount of fragmentation, the Executive 
may fail to find space to fulfill a checkpoint request. In this case, 
a task that is intended to get into memory does not get in until 
additional memory or checkpoint space becomes available. 


If a critical task must get into memory, it may be unacceptable for a 
checkpoint operation to fail. To ensure that any given task can 
always be checkpointed, allocate checkpoint space in the task image 
file. There can be no checkpoint allocation failures in partitions in 
which all active tasks have preallocated checkpoint’ space. For 
example, all tasks running in SYSPAR- should have preallocated 
checkpoint space. A task which has checkpoint space preallocated in 
its task image file is checkpointed to this space only if the 
Executive fails to find space for the task in the checkpoint files. 
With this algorithm, the Executive tends to checkpoint a task to the 
fastest device when a task was installed from a slower device. 


Selection of the Extend Task directive during SYSGEN allows tasks to 
increase or decrease their memory allocation during execution. 
Although this feature does not require dynamic checkpoint’ space 
allocation, its flexibility is limited without it. The system 
utilities, MACRO and Task Builder, use the Extend Task directive’ to 
maintain a memory-resident symbol table until reaching the maximum 
Size as specified by the system manager. In a system that supports 
the Extend Task directive, these utilities can be installed with an 
increment as low as 2048 to reduce their initial memory requirements. 
For large assemblies and task-builds these utilities increase their 
size to the operator-set maximum for increased speed, and return to 
their original size before processing the next command. 


4.9.9 QIO Speed Optimizations 


If you select the QIO speed optimizations during SYSGEN, the speed of 
QIO operations are increased in the following three ways: 


l. I/0 packets are preallocated 
2. BLXIO (block transfer) speed is optimized 


3. I/0 completion is overlapped. 


4.9.9.1 I/O Packet Preallocation - The Executive maintains a LIFO 
list of preallocated I/0 packets; the maximum size of the list is 
specified by the system manager. When an I/O packet is required, the 
Executive removes one from this list. If the list is empty, the 
Executive allocates the packet from dynamic memory; this is a 
Significantly slower operation. When an I/O packet is deallocated, it 
is linked into the list if the list is not full. Thus, in each 
non-ACP I/O request, two fast LIFO list operations replace the slower 
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core allocations and deallocations, saving several hundred 
microseconds. Some I/O requests involving ACPs require two I/0 
packets and therefore benefit twice as much. 


In considering the number of I/O packets to preallocate, the number 
should be considered on the normal fluctuation in the total number of 
I/O requests, which is always a smaller number than the total number 
of I/O requests typically outstanding on the system. The storage 
needed is 18 words per I/O packet. 


4.9.9.2 BLXIO (Block Transfer) Speed Optimizations - This feature 
optimizes the Executive routine S$BLXIO in the module BFCTL for mapped 
systems only. The optimizations are as follows. 


1. The routine decides whether or not it can perform the 
transfer a word at a time, as opposed to a byte at a time. 


2. Vectors of word and byte MOV instructions are allocated (up 
to a user-specified length) to save time on loop control 
during the move. For example, if you specify 16 words in 
each vector, a 36 word transfer causes the loop control to be 
entered three times as opposed to 36 times if there was a 
single MOV instruction. 


The following users can benefit from this feature: 
1. File system ACP (for open and close operations) 
2. The shuffler task 


3. DECNET 


4.9.9.3 Overlapped I/O Completion - This support causes the execution 
of I/0 completion code for each I/O request to be postponed until the 
next request has been initiated. If I/O requests are in the driver's 
queue, this action causes the Executive to complete the I/O processing 
while the physical device services the next request. A minor. side 
effect of this feature may cause multiple I/O requests to the same 
device to complete in an order other than the issued order. 


4.9.10 Multiuser Protection 


The following sections summarize the implications of multiuser 
protection on various system directives. Refer to the RSX-11M 
Executive Reference Manual for a detailed description of Executive 
directives. 


4.9.10.1 Abort, Resume, and Cancel Schedule Requests - These 
directives, when issued from a nonprivileged task, are rejected for a 
privilege violation if the target task does not have the same fMTI 
terminal (i.e., waS not initiated from the same terminal). The CANCEL 
SCHEDULE REQUESTS directive is rejected if the TI address of the 
nonprivileged issuing task is not CO:. 
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4.9.10.2 Request and Run - If a nonprivileged task issues a REQUEST 
directive that specifies a UIC different from its own, only the 
default UIC of the requested task is set to the UIC specified. The 
protection UIC of the requested task is the same as that of the 
requesting task. Because of a data structure size limitation, 
nonprivileged tasks cannot specify a UIC other than their own in a RUN 
directive. 


4.9.10.3 Queue I/O Request - A nonprivileged task cannot issue an I/O 
request to a privately allocated device unless its TI terminal is the 
same as the terminal to which the device is allocated (i.e., it owns 
the device). 


4.9.10.4 Slave Tasks - Slave tasks perform functions for other’ tasks 
on a SEND DATA and REQUEST basis. Examples supplied with RSX-11M are 
the print spooler and cross-reference tasks. When a slave task issues 
a RECEIVE DATA directive, it automatically assumes the TI terminal and 
protection UIC of the sender task. Thus, a slave task always has’ the 
same access to files and allocated volumes as its sender tasks. 
However, when a Slave task issues an ASSIGN LUN directive, all logical 
assignments for the current TI of the slave task (via the MCR ASN 
command) are ignored. Note that file specifiers to the print spooler 
and cross-reference tasks always include actual physical device names 
resolved prior to the issuance of the SEND DATA directive according to 
the logical device assignments in effect at that time. 


4.9.11 Multiple ACPs - Executive Interface 


The Executive supports a multiple ACP interface to the ACPs, MCR, 
Shuffler, and Loader. When these tasks are active, but detect that 
there is nothing for them to do, they set a bit in their task control 
block which makes them checkpointable by any other’ task in the 
partition, regardless of priority. The Shuffler exits when all 
system-controlled partitions in the system have reached a stable state 
(see Section 4.1.4); MCR and the Loader are now always active. The 
interface provides the following benefits: 


1. Multiple ACPs can share the same partition. In fact, the 
partition may further be shared with MCR, the Shuffler and 
TKTN if desired. 


2. MCR and the Loader never exit, thereby improving the response 
to these system tasks. Furthermore, if MCR is placed in a 
dedicated partition, or in a partition with only the Shuffler 
and TKTN, it tends to remain in memory between commands for 
even faster response. 


4.9.12 ALTER PRIORITY. Directive 


The ALTER PRIORITY directive allows one task to modify the priority of 
itself or another task. Any control blocks associated with the task 
in priority-ordered queues are reordered immediately. This includes 
such things as the task control blocks and I/O packets. Any I/0 
packets for the task which are currently being processed by a driver 
or ACP are not affected. In systems with multi-user protection, a 
task must be privileged to issue this directive. 
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One possible use of the ALTER PRIORITY directive is .to implement 
scheduling algorithms to run in addition to or instead of the 
Executive's round-robin scheduling and disk Swapping algorithms. Such 
scheduling algorithms could be implemented by a task using the ALTER 
PRIORITY directive that runs both privileged and at high priority. 


Two MCR features use the ALTER PRIORITY directive: 


A 


The ABORT MCR command elevates a task's priority to 247 when 
it is being aborted, thus allowing the task to exit the 
system guickly. 


The MCR indirect command file processor task AT., alters its 
priority to 10 whenever waiting for a task to exit. It 
returns to its installed priority after detecting the task's 
exit. Thus, with the ALTER PRIORITY directive in the system, 
the /PRI option of INSTALL may be used to install AT. at a 
high priority such as 65 to make the processing of indirect 
command files more responsive. If the Alter Priority 
directive is not in the system, AT. must be installed with a 
priority of 10. 


CHAPTER 5 


VMR COMMANDS 


5.1 COMMAND SUMMARY 


The Virtual Monitor Console Routine (VMR) commands specified in this 
chapter are listed below by category. This command summary provides a 
compact overview of the facilities available through VMR. The 
detailed descriptions of the VMR commands given in Section 5.6 are 
presented in alphabetical order, according to command name, for quick 
reference. 


Initialization Commands 


ASN Define or delete a global logical device assignment. 
List current assignments on user's terminal. . 


INSTALL Install a task in the system image. 

LOAD Load a device driver. 

REDIRECT Redirect all I/O staged from one physical device to 
another. 

SAVE Write the system image of memory onto a_=e secondary 


media in boot-strappable format. 

SET Set system and terminal characteristics; define 
partitions; display terminal and partition | 
characteristics on entering terminal. 


TIME Enter time and/or date into the system image; display 
the time and date on entering terminal. 


UNLOAD Unload a device driver. 


Informational Commands 


DEVICES Display on the entering terminal a list of peripheral 
devices defined in the system image. 


LUNS Display on the entering terminal the list of LUN 
assignments for an indicated task. 


PARTITIONS Display on the entering terminal the list of 
partitions defined in the system image. 


TASKLIST Display on the entering terminal a list of all tasks 
installed in the system image. 
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Task Control Commands 


ALTER Alter the priority of a task. 

CANCEL Cancel time-based initiation requests for a task. 

FIX Fix a task in system image. 

REASSIGN Change a task's LUN assignment. 

REMOVE Remove a task from the system image. 

RUN Schedule a task's activation. The task may run after 


one clock tick, after a delay, or in synchronization 
with the system clock. Periodic rescheduling is 
optional. 


UNFIX Unfix a task from the system image. 


5.2 MONITOR CONSOLE INTERFACE 


5.2.1 Introduction 

The Virtual Monitor Console Routine (VMR) is an RSX-11M system program 
that allows the complete online configuration of RSX-11M and RSX-11S 
systems. As its name suggests, VMR provides the capability to execute 
MCR commands that are directed to the disk image of a system. 

VMR supports a compatible subset of the MCR commands described in the 
RSX-11M Operator's Procedures Manual. All supported commands have 


identical syntax and semantics as their MCR counterpart with the one 
exception of the SAVE command. 


5.2.2 Starting VMR 
You have four methods for starting VMR. The first three methods apply 
when VMR is installed and ready to be executed. The fourth method 
installs VMR, executes it, and then removes it on exit. 
Method 1: 

>VMR @indirect 


The system loads VMR, executes the specified indirect command 
file, and then VMR exits. 


Method 2: 
>VMR 


The system loads VMR and then VMR responds with the following 
prompt: 


ENTER FILENAME: 
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Method 3: 
>RUN VMR 


The system loads VMR and then VMR' responds with the _ following 
prompt: 


ENTER FILENAME: 
Method 4: 
>RUN SVMR 
The system installs VMR from the pseudo device LB: under’ the 
system UIC (normally, [1,50] or [1,54]), loads it, and VMR then 
responds with the following prompt: 
ENTER FILENAME: 
In all starting methods except method 1, VMR prompts with: 
ENTER FILENAME: 


At this point, you specify the file that contains the image of the 
RSX-11M or RSX-11S system to be modified. A symbol table file 
corresponding to the system image file with the same filename, but 
with file type .STB, must be under the same UIC. (See exception 
described for the /IM switch below.) For example, if you entered _ the 
file specifier RSX11S.SYS in response to the 


ENTER FILENAME: 


prompt, a corresponding file, RSX11S.STB, must exist that contains the 
symbol definitions for the RSX11S.SYS system image. 


The system image and symbol table files are in the standard format 
produced by the RSX-11M Task Builder. 


Upon receiving a valid file specifier, VMR opens and reads the symbol 
table file; it also opens the system image file and verifies that the 
file is actually a system image. VMR then prompts with 

VMR> 


and waits for you to enter a command. You may enter any valid VMR 
command or end VMR by typing CTRL/Z*. 


If you used method 1 to start VMR, the specified file contains a 
series of commands to be executed by VMR. The first record in the 
file must contain a file specifier for the system image file that is 
to be modified. 


In addition to specifying an indirect file to start VMR, you may also 
enter 


@filespecifier 


anytime that VMR is prompting for input. This directs VMR to get 
input from the specified file until it reaches an end-of-file and to 


*CTRL/Z is typed by simultaneously depressing the CTRL and Z keys. 
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return to the terminal for further input. This feature of VMR is very 
useful in cases where a series of INSTALL commands, for example, are 
to be repeated for several generated systems. 


5.3 VMR FILE SPECIFIERS 
File specifiers accepted by VMR are in the standard RSX-11M form: 


dev: [g,m] filename.type;ver/sw 


where: 
dev: is the device-unit on which the volume containing the 
desired file is mounted, for example, DKO: or DTl:. 
The name consists of two ASCII characters followed, by 
an optional 1l- or 2-digit octal unit number. 
Default: SY0O: 
[g,m] is the User File Directory (UFD), consisting of a group 


number and a member number. 
Default: the UIC under which VMR is running. 


filename is the name of the file. In RSX-11M, a filename can be 
up to nine alphanumeric characters in length. Filename 
and type are always separated by a period (.). 


Default: mone; must be specified. 


typ is the the file type, consisting of up to three 
alphanumeric characters. 


Default: SYS for system image files, and CMD for 
indirect files. 


ver is the version number in the range 0 through 77777(8). 
Default: highest version. 


/Sw is a 2-character ASCII name identifying a _ switch 
option. 


Only one switch option (/IM) iS provided with VMR; it is used in 
conjunction with the Save command to write non-RSX-11M/RSX-11S system 
images to secondary media in bootstrappable format. The switch may be 
specified only on the system image file and overrides the requirement 
for the symbol table file. 


When the /IM switch is specified, the only command VMR will accept is 
the Save command. The /IM switch is useful when RSX-11M is used as a 
host system to develop and create small, core-only systems that must 
be loaded from a serial medium such as paper tape. 


5.3.1 Command Syntax 


It is not necessary to type the entire command name when entering a 
command. VMR requires only the first three letters of a command name, 
followed by the command parameters, if any exist. If parameters 
exist, they must be preceded by at least one blank or tab. 
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The following example shows how the Time command can be_ specified. 
Note that the square brackets in the example indicate that the "E" is 
optional; the square brackets are not part of the command name. The 
angle brackets denote that the enclosed values are not literally part 
of the command syntax. For example, <CR> indicates that a carriage 
return terminates the input line. 


VMR>TIM[E] <CR> 
14:00:04 21-NOV-77 


Thus, either 
VMR>TIM <CR> 
or 
VMR>TIME <CR> 


is acceptable. 


5.3.2 Keywords 


Some commands use keywords that generally apply to a command argument. 
A keyword consists of a Slash (/), followed by an ASCII 
identification, and optionally followed by an equal sign (=) aand_ the 
value of the keyword, as follows: 


/Keyword=value 


Keywords can be entered in any order. As an example of keyword usage, 
the INSTALL command requires a filename argument specifying the task 
to be installed. Keywords can be appended to the filename. One such 
keyword, /TASK, can specify the name under which the task is to be 
installed. Thus, 


VMR>INS JIM.TSK/TASK=SUPER 


causes the task contained in the file named JIM.TSK to be installed 
with a name of SUPER. Keywords are command-specific and are defined 
with each command. 


5.3.3 Comments 


VMR treats a line of text as a comment if the first character in the 
line is a semicolon (;). In addition, the exclamation mark (!) may be 
used to delimit comments in a command. The first exclamation mark 
starts the comment and the next exclamation mark or end of line 
terminates the comment. All text between the two exclamation marks is 
ignored. For example: 


>; THIS LINE IS A COMMENT 
>TAS ! THIS IS A COMMENT STRING! 
Comments are especially useful to clarify commands in VMR_ indirect 


command files. (See the RSX-11M Operator's Procedures Manual for 
further information about indirect command files.) 
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5.4 COMMAND NAMES 


Command names are at least three characters in length. VMR accepts 
the first three characters of a command and then searches for a blank, 
tab, carriage return, or ESCape character. Therefore, embedded blanks 
are not allowed in a command name. If a command is’ entered 
incorrectly, VMR displays an error message at the entering terminal. 


Syntactical descriptions of commands and messages described in this 
chapter observe the following notational conventions: 


5.4.1 Lower-Case 


Lower-case indicates a variable with an actual value determined when 
the command is entered or the message is issued. For example, the 
value of taskname depends on the name of the task associated with the 
command or message. 


5.4.2 Brackets [] 


Brackets [] enclose optional items. A syntactical element enclosed in 
brackets (for example, [dt]) is optional; it may or may not be 
included in the command. One common exception to this rule is the 
syntax for the specification of a UIC. The format for a UIC is [g,m], 
where the square brackets are required syntactical elements. 


5.4.3. Numeric Values 
Numeric values may be entered in a command as decimal or octal unless 
explicitly qualified. Decimal values are indicated by a trailing 
period; octal values are indicated by the absence of a trailing 
period. Thus, 

255. and 377 


have the same value. (The number 255. is decimal; the number 377 is 
octal.) 


5.5 COMMAND DESCRIPTION FORMAT 

The following subheadings are _ used in the detailed command 
descriptions given in Section 5.6. Subheadings that do not apply to a 
particular command are omitted from the command description. 

COMMAND NAME 

This subheading identifies the command name in capital letters. The 
Minimal VMR command acronym is shown on the right margin. The text 
following this subheading describes the command's function. 

The command format is given, and all parameters are described. 


Examples: 


Example uses are shown. 
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Notes: 


A list of special considerations that may assist the programmer 
in using the command properly appears under this subheading. 


Command Related Error Messages: 


Error messages specific to the command appear’ under this 
subheading. The command may also produce the common error 
messages listed in Section 5.7. These common error messages are 
not listed with the individual commands presented in this 
chapter. 
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5.6 VMR COMMAND DESCRIPTIONS 


ALTER | . ALT 
The ALTER command allows the operator to change the static priority of 
an installed task. The format of the ALTER command is: 


ALT[ER] taskname /PRI=priority 


where: 
taskname The name of the task whose priority is to be altered. 
/PRI Changes the task's static priority. 
priority The new priority to be assigned to the specified task, 
from 1 to 250 (decimal). 
Example: 
>ALT TEST /PRI=248. 


Alter the static priority of task TEST to 248(10). 
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ASSIGN ASN 


The ASSIGN command defines, deletes, or displays logical-device 
assignments. Logical-device assignments are a way to associate 
logical names with physical devices, pseudo devices, or other logical 
devices. When you assign a logical name to a pseudo or logical 
device, the system resolves the assignment to the associated physical 
device. There are three types of logical-device assignment: global, 
local, and login. VMR supports the manipulation of global assignments 
only. See the RSX-11M Operator's Procedures Manual for additional 
information on local and login assignments. 


The manipulation of global assignments applies to all tasks in the 
running system. 


A logical-device name has the same syntax as a physical device unit; 
it consists of a 2-character ASCII name (alphabetic) and an optional 
l- or 2-digit octal unit number, followed by a colon (:). The 
2-character name either can be equivalent to a standard RSX-11M device 
name (for example, DK:) or two letters picked at random (for example, 
» oS A 


When you install a task, or the system executes an ASSIGN’ LUN 
directive, the system scans the logical device table before the 
physical device table when it searches for a specified device. As a 
result, you can define logical device names that are identical to 
physical device names even though the logical and physical device 
names do not refer to the same physical device. The system resolves a 
specified device name to the first matching table entry found. If a 
logical device name is identical to a physical device name, the 
logical name has precedence. 


The formats of the ASSIGN command are: 


ASN ppnn:=llnn:/GBL 


Define a global assignment that associates the logical name linn: with 
device ppnn:. 


ASN /GBL 
Display all global assignments for the system. 
ASN =[llnn:]/GBL 


Delete the specified global logical-device assignment or all global 
assignments if the command omits llnn:. 


where: 
pp Physical, logical, or pseudo device name 
nn Unit number 
1l Logical device name 


Examples: 
VMR>ASN 


VMR>ASN 
GBO: 


VMR>ASN 


DK: =GB0: /GBL 


/GBL 
DKO: GLOBAL 


=/GBL 


Command Error Messages: 
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!Define global logical device name 


!List all assignments 


!Delete all global assignments 


VMR -- LOGICAL DEVICE NOT IN SYSTEM 


The specified logical device name was not defined and therefore 
could not be found in the logical device assignment table. 


VMR -- PSUEDO DEVICE ASSIGNMENT ERROR 


A logical device name cannot be assigned to a pseudo device. 
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CANCEL CAN 


The CANCEL command allows you to cancel time-based initiation requests 
for a task. These requests result from the RUNS directive or any of 
the time-synchronized variations of the MCR or VMR RUN command. 

CANCEL does not affect the execution of the task that may be active in 
the saved system image. It removes only the time-based schedule 
requests still in the queue. 

The format of the CANCEL command is: 


CAN[CEL] taskname 


Example: 
VMR>CAN XKE 


Cancel all periodic rescheduling and time-based initiation 
requests for task XKE. 
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DEVICES DEV 
The DEVICES command displays on the entering terminal the symbolic 
names of all device-units or, optionally, all of a particular device 
type defined in the system image. The device names appear in one 
column; a second column contains additional information (when 
necessary) about each device. 
The format of the DEVICE command is: 

DEV [ICES] 

DEV dd: 


where: 


dd is the particular device type to be displayed. 


Examples: 


VMR>DEV 

DBO: LOADED 
DB1: LOADED 
DB2: LOADED 
DB3: OFFLINE LOADED 
DKO: LOADED 
DK1: 

DK2: 

DSO: 

DSI: 

DTO: LOADED 
DTl: LOADED 
LPO: LOADED 
MMO: LOADED 
MM1: LOADED 
PPO: UNLOADED 
PRO: UNLOADED 
TTOs: 

TTl: 

TT2: 

TT3: 

TT4: 

coo: TTO: 
CLO: LPO: 
SY0: DBO: 
VMR>DEV DK: 

DKO: LOADED 
DK1: 

DK2: 


Please note that the pseudo device SY: is not Redirected until the 
system is booted. The following notes describe the messages that can 
appear in the second column. More than one message can appear on the 
same line. 


e OFFLINE indicates that, although the system tables contain 
entries for this device, the system as saved did not contain 
the related device. 


e LOADED indicates that the driver for the device is loadable 
and is currently loaded. 
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UNLOADED indicates that the driver for the device is loadable 
and is currently not loaded. 


A device name in the second column is the device to which the 
corresponding device in the first column has been redirected. 


Absence of either LOADED or UNLOADED in the second column 
indicates that the driver is permanently resident; it is 
linked with the Executive. 
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FIX-IN-MEMORY FIX 
The FIX-IN-MEMORY command allows you to load a task into its partition 
in the system image. Requests for running the task can be serviced 
more quickly because the task is memory-resident and does not have to 
be loaded from the disk before it can run. VMR can fix a task in the 
system image only if the partition in which it is to be fixed is 
available. The command cannot be used to fix a task in a system 
controlled partition. On RSX-11S systems, all installed tasks must be 
fixed since they cannot be loaded into the running RSX-11S system. 
Fixed tasks remain physically in memory even after they exit. 
Therefore, they do not have to be reloaded when a request is made to 
run them. (Note that re-executing fixed tasks is not always 
practical.) Only an UNFIX or REMOVE command can free the occupied 
partition. 
The following restrictions apply to the fixing of tasks: 

e Checkpointable tasks cannot be fixed, 

e Active tasks cannot be fixed, 

e A task must be installed before it can be fixed, 


e VMR cannot fix a task into a system controlled partition. 


The format of the FIX~IN-MEMORY command is: 
FIX taskname 
Example: 
VMROFIX XKE 
FIX task XKE in its partition. 
Command Error Messages: 
VMR -- CANNOT FIX A TASK IN A SYSTEM CONTROLLED PARTITION 
This is a restriction of VMR. To fix a task in ae system 
controlled partition, use the MCR FIX command and then SAVe the 
system image. 


VMR -- FILE name HAS INCONSISTENT DATA 


The task or partition that you are trying to fix is logically 
beyond the end of the system image file. 


VMR -- PARTITION BUSY 


The partition in which the task was to be fixed was occupied, so 
the task could not be fixed. 


VMR -~ TASK ALREADY FIXED 
The specified task was already fixed in memory. 
VMR ~- TASK CHECKPOINTABLE 


The subject task was checkpointable. A checkpointable task 
cannot be fixed in memory. 
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INSTALL INS 


The INSTALL command makes a specified task known in the system image, 
or loads a resident library into a common partition in the system 
image. An installed task is dormant until the Executive receives a 
request for it to run. The optional keywords either provide 
parameters that were not specified at task build, or they override 
previously specified parameters. 


When a task is installed, VMR creates a Task Control Block (TCB) for 
the task in a system image table called the System Task Directory 
(STD). The task parameters contained in the TCB enable the system to 
run the task when requested to do so by an MCR command, VMR command, 
Or a system directive. A task cannot be run until you install it. 


A task's TCB contains the address of the load-device Unit Control 
Block (UCB) and the Logical Block Number (LBN) of the task image file. 
The Executive can therefore load the task image in one transfer when 
an MCR command or system directive requests an installed task. 
(Loading does require more than one transfer if the task is greater 
than 32K words.) 


When VMR installs a task in a virgin system, it stores the task's file 
identification in the task header. When you save a system, the SAVE 
command places the file identification, rather than the file's LBN, in 
the TCB. Then, when the system is rebooted, it reopens the task file 
and stores the new current LBN of the task in the TCB. If a task has 
been deleted, the system cannot open the task file when the system is 
rebooted. The system then automatically removes the task's TCB from 
the STD. When VMR installs a task in a saved system image, it stores 
the task's file identification rather than the LBN in the TCB to allow 
a reboot to occur successfully. 


Also a saved system does not retain the physical addresses of 
installed tasks. The Disk Save and Compress (DSC) utility can 
compress and copy a disk containing a saved system, thus moving the 
task files to different physical locations. But because the TCB 
entries contain task file identifications, rather than LBNs, after a 
system save, the system can function normally when it is rebooted. 
The format of the INSTALL command is: 
INS[TALL] filespec[/keyword] [/keyword]... 
Keywords: 
/CKP=option 
/INC=Ssize 
/PAR=pname 
/PMD=option 
/PRI=number 
/SLV=option 
/TASK=taskname 


/UIC=[group,member ] 


where: 


filespec 


CKP 


INC 


PAR 


PMD 
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is the file specifier in the form: 
dev: [group,member] filename.type;version 


The type defaults to TSK; standard defaults apply to 
the remaining fields. 


/CKP=option. Checkpoint option. If CKP=YES (default 
for checkpointable tasks), checkpointing is allowed. 
If CKP=NO, checkpointing is disabled for the task. 


The /CKP keyword overrides the /CP switch specified at 
task build. 


On systems that support the dynamic allocation of 
checkpoint space, the task image file does not need to 
contain allocated checkpoint space. The presence of 
the /CKP=YES keyword instructs the system to allocate 
checkpoint space for the task when required from a 
checkpoint file. 


/INC=size. The number of additional words of address 
space to be allocated to a task that is to run ina 
system-controlled partition. The extension size is 
usually expressed in octal but may also be expressed in 
decimal by appending a period. This keyword overrides 
the EXTTSK or PAR parameter used at task-build time. 
Tasks that specify the size of the partition in which 
they are running use this keyword to identify how much 
dynamic space they may allocate to symbol tables or 
buffers. Tasks such as MACRO-11, TKB, PIP, VFY, and 
AT. use the space from the end of the task image to 
the end of their address space as dynamic memory. In 
effect, the INC keyword defines the number of words in 
this dynamic region. 


Default: size specified at task-build time, or zero. 


/PAR=pname. A partition name that overrides the 
partition specified at task-build time. In an unmapped 
system, the specified partition must have the same base 
address as the partition for which the task was built. 


If the keyword specifies a nonexistent partition, VMR 
issues a warning message and attempts to install the 
task in the GEN partition. 


Default: TKB uses the name GEN. (See Chapter 4 for an 
explanation of multiuser system defaults.) 


/PMD=option. Post-Mortem Dump option. If PMD=YES, a 
post-mortem dump is requested for the task if it aborts 
because of an SST error condition. If PMD=NO (the 
default from a task-build), no dump is requested at SST 
abort time. To generate a dump, the post-mortem dump 
task PMD... must be installed in the system. This 
keyword overrides’ the /PM switch specified at 
task-build time. 


Default: Specified at task-build time. 


PRI 


SLV 


TASK 


UIC 


Examples: 
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/PRI=number. Priority number. The value range is 1 
through 250(10). Number conventions apply. 


Default: /PRI=50. 


/SLV=option. Slave task option. The two options are 
YES and NO. If the command specifies /SLV=YES, data 
sent to the installed task is marked with the TI: of 
the sending task. When the installed task receives the 
data, the system sets the task's TI: to that 
associated with the data. This keyword overrides the 
/SL switch specified at task build. 


If the command specifies /SLV=NO, the TI: of the task 
does not change when receiving data. 


Default: Specified at task build. 


/TASK=taskname. The name by which the task is to be 
referred. 


Default: The name specified at task-build time or the 
first 6 characters of the filename. 


/UIC=[group,member]. The square brackets are required 
syntax. This UIC is the default for the task. It can 
be overridden in the RUN ' command. The task UIC 
determines into what file-protection class (system, 
owner, group, world) a task belongs, and thus’ directly 
influences file access. Note that file protection may 
differ from file to file. 


Default: default from task build. This default 
applies only to tasks started by a RUNS directive or a 
RUN command that specifies a time delay before runtime. 
Tasks started by typing the name as a command (for 
example, PIP and TKB) run under the default UIC of the 
terminal from which the command was issued. 


VMR>INSTALL SCAN 


Install task SCAN. Priority and UIC defaulted. 


VMR>INSTALL DK1: [1,111]SCAN.TSK;4/PRI=103 


Install task SCAN, file type TSK, version 4 on device DKl:, group 
number 1, member number 111, with a priority of 103(8). 


VMR>INS MAC/INC=4096./PAR=SYSCTL 


Install task MAC in the system-controlled partition SYSCTL and 
increase the task size by 4096 decimal words. 
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Command Error Messages: 
VMR -- ADDRESSING EXTENSIONS NOT SUPPORTED 
The command tried to install a task with a VSECT (virtual 
section) into a system image that does not support the feature. 
VMR -- BASE ADDRESS MUST BE ON 4K BOUNDARY 
The base virtual address of the task was not on a 4K _ boundary. 
This message is applicable only to mapped system images. 
VMR -- BASE MISMATCH COMMON BLOCK <common-name> 
The base address of the partition did not match that of the 
common block. This message is applicable only to unmapped system 
images. 
VMR -~- CHECKPOINT AREA TOO SMALL 
The area allocated for checkpointing in the task image file was 
smaller than the partition into which the task was being 
installed. The system image does not support the dynamic 
allocation of checkpoint space. 
VMR. -- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 
A warning message. The checkpoint space allocated in the task 
image file is too small for the size of the task (usually because 
of the /INC keyword). The system image supports the dynamic 
allocation of checkpoint space and will therefore use a 
checkpoint file to contain the rolled-out task. Note that’ since 
no checkpoint file exists when the systm is booted, this message 
should be considered a fatal error if it is issued by any of the 
tasks used by the system during the boot. These tasks ares MCR; 
MOV; and FIIACP. 
VMR -- COMMON BLOCK IS TASK PARTITION <common-name> 
A task's request for access to a common block was rejected 
because the requested partition was a task partition. 
VMR ~~ COMMON BLOCK NOT LOADED <common~name> 
The specified common block was linked to the task but had not 
been installed into the system image. Install the common block, 
then install the task. 
VMR -- COMMON BLOCK OCCUPIED 


An attempt was made to load a common block that was occupied. 
VMR -- COMMON BLOCK PARAMETER MISMATCH <common-name> 


Parameters of a common block did not match those in the task's 
label block. 
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VMR ~~ COMMON BLOCK SEGMENT COUNT ERROR 


The command tried to install a resident library with overlays, 
but the number of overlay segments specified in the task header 
is different from the number specified in the segment 
descriptors. 


VMR -- DEVICE ddn: NOT IN SYSTEM 


The specified device is not defined in the system image. 


VMR -- FILE filename HAS INCONSISTENT DATA 


When loading a common library, the partition extended beyond the 
Size of the task image file and thus could not be loaded. 


VMR -- FILE NOT CONTIGUOUS 


An attempt was made to install a task from a non-contiguous file. 
Task images must be contiguous files. 


VMR -- FILE NOT TASK IMAGE 


Data in the label block was not correct, indicating that the file 
was not a task image. 


VMR -- ILLEGAL FIRST APR 


A task was built using a base APR other than zero for 
non-privileged tasks or APR 4 or APR 5 for privileged tasks. If 
the Executive has been built to support 20K of address space, APR 
5 is the only valid base APR for tasks mapping into the 
Executive. A privileged task that does not map into. the 
Executive must use APR 0O as its base. (See the RSX-11M Task 
Builder Reference Manual for a description of the /PR_ keyword.) 
This message applies only to mapped system images. 


VMR -- ILLEGAL PRIORITY 


The value of the priority specified in the command was out of 
range (that is, not 1 to 250(10), inclusive). 


VMR -- LENGTH MISMATCH COMMON BLOCK <blockname> 


The length parameter for the common block, as described in the 
label block for the task image, did not match the corresponding 
length parameter defined in the system image. A task's label 
block data must match system data for that task before it can be 
installed. 
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VMR -- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


This is a warning message. The command attempted to install the 
task as checkpointable; but the task was not built as 
checkpointable with checkpoint space allocated in its task image 
file. Because the system does not support the dynamic allocation 
of checkpoint space, it considers’ the task not to be 
checkpointable. 


VMR -- NOT ENOUGH APRS FOR TASK IMAGE 

The Task Builder allows the user to specify the virtual base 
address of a task image as a multiple of 4K. Privileged tasks 
Start at virtual 100000(8) to map the first 16K of the Executive, 
or virtual 120000(8) to map the first 20K of the Executive, at 
the same time as the user task. If the virtual base address is 
set too high, the task image may not be able to be mapped with 
the remaining mapping registers. This message is applicable to 
Mapped system images only. 

VMR -- PARTITION NOT COMMON 

A partition specified for a common area or library is not defined 
aS a common partition. 

VMR -- PARTITION par NOT IN SYSTEM, DEFAULTING TO GEN 

This is a warning message. The specified partition does not 
exist; VMR therefore attempts to install the task in the GEN 
partition. 

VMR -- PRIVILEGED TASK LARGER THAN 12K 

A privileged task was larger than 12K. Privileged tasks on an 
unmapped system have a maximum size of 12K. 


VMR -- SPECIFIED PARTITION FOR COMMON BLOCK 


A task was being installed into a common block. 


VMR -- SPECIFIED PARTITION TOO SMALL 

The task being installed was larger than the partition into which 
it was being installed. 

VMR -~ TASK AND PARTITION BASES MISMATCH 

The base of the partition did not match the base of the _ task 
being installed. This message applies only to unmapped systems. 
VMR -- TASK IMAGE I/O ERROR 


VMR could not read the task-image file, or could not rewrite the 
task-image header (the device is write-locked.) 
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VMR -- TASK IMAGE CURRENTLY INSTALLED 

The requested task image, which was checkpointable, had already 
been installed. On systems that do not support the dynamic 
allocation of checkpoint space, checkpointable tasks that have 
checkpoint space allocated can be installed only once; other 
tasks can be installed more than once. 

VMR -- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK <block-name> 
The virtual addresses reserved for the task image overlap those 
reserved for the common block specified in the message. A 
corruption of the task image file probably caused the overlap. 
VMR -- TASK NAME ALREADY IN USE 

An attempt was made to install a task with the same name as_ one 
already in the system image. 

VMR -~ TOO MANY COMMON BLOCK REQUESTS 

A task made too many common—-block requests. A task is limited to 
seven common-block references. 


VMR -- TOO MANY LUNS 


A task requested more than 255(10) LUNs to be assigned. 


VMR -- UNDEFINED COMMON BLOCK <blockname> 

A task referenced a common block that is not defined in the 
system image. Usually, this message indicates that the task was 
built for another system. 


VMR -- WARNING - PRIVILEGED TASK OVERMAPS I/O PAGE 


A privileged task that is mapped into the Executive is usually 
also mapped into the I/O page in order to access the KT11 


registers and other devices. Many privileged tasks do not 
require this access and can use the additional 4K words of 
virtual address ‘space for the task image. This message warns 


that a privileged task that may require access to the I/O page 
does not have the access. 
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LOAD LOA 


The LOAD command loads a nonresident device driver into the system 
image and constructs the data base and interrupt vector linkages 
required to allow access to the device. This command eliminates’ the 
need to link infrequently used device drivers permanently into the 
Executive. (Executive support of loadable device drivers is a system 
generation option.) 


The command includes an optional keyword that specifies the partition 
into which the driver is to be loaded. The specified partition cannot 
be a common partition; but all other types of partition are 
permissible. If the command does not name a partition, VMR loads the 
driver into the partition chosen when the driver was built. 
The format of the LOAD command is: 

LOA[D] dd: [/PAR=parname] 
wheres 

dd: is a 2-character ASCII device name 

parname is the name of the partition into which the driver 

is to be loaded. 

Examples: 


VMR>LOAD MM: !LOAD TU16 DRIVER (MMDRV) 


VMR>LOA LS: /PAR=DRVPAR !LOAD LPS11 DRIVER (LSDRV) INTO DRVPAR 


Notes: 


e Guidelines for building loadable device-driver tasks are 
rigidly defined. These guidelines are described in the RSX-11M 
Guide to Writing an I/O Driver. Note that the system 
generation procedures include provisions to simplify the task 
building of drivers. 


e The LOAD command requires that a driver's TSK and STB files 
reside under the same UIC and on the same disk as the system 
image being worked on. For example, the command 


LOA ODT: 


requires that the files DTDRV.TSK and DTDRV.STB reside on SY: 
under the current UIC. 


e The LOAD command requires pool space as follows: 


1. If the driver data base is being loaded, the command needs 
pool space equal in size to the size of the data base. 


2. In a mapped system, the command needs pool space for an 
Interrupt Control Block (ICB) for each interrupt entry 
point in the driver. 


3. If the driver is being loaded into a _system-controlled 
partition, the command needs pool space for a Partition 
Control Block (PCB). 
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Command Error Messages: 


VMR -- DEVICE ddn: NOT IN SYSTEM 

The data base for the device driver was neither in the system 
image nor in the driver's task image. 

VMR -- DRIVER ALREADY RESIDENT 

The specified device driver is already loaded or is permanently 
resident in the system image. 

VMR -- DRIVER BUILT WITH WRONG STB FILE 

The STB file for the driver is not compatible with the Executive 
STB file for the current system image. 

VMR -- DRIVER REQUIRES RUNNING SYSTEM FOR LOAD/UNLOAD 

The requested driver included the symbols $ddLOA or $ddUNL in its 
source. Support of driver load/unload calls can only be provided 


by MCR LOAD/UNLOAD. Note however, that these symbols are 
reserved for future use by the MCR LOAD and UNLOAD commands. 


VMR -- FILE name HAS ILLEGAL FORMAT 


The driver's STB file contained illegal object code or data. 


VMR -- FILE name HAS INCONSISTENT DATA 


The partition for loadable drivers is logically beyond the end of 
the system file image. 


The driver task was not built according to guidelines. See the 


RSX-11M Guide to Writing an I/O Driver. Alternatively, the 
driver has an invalid loadable data base. 


VMR -~ FILE name NOT A VALID DRIVER TASK IMAGE 

The driver's task image was either overlaid, had a task header, 
or referenced a resident library. 

VMR -- FILE NOT CONTIGUOUS 


The file ddDRV.TSK was not’ contiguous. The file must be 
contiguous. 


VMR -- ILLEGAL DRIVER TASK APR USAGE 


A device driver must be built for APR 5 and must be less than 4K 
(e.g. PAR=DRVPAR:120000:20000). This message applies to mapped 
systems only. 
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VMR -- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 

The symbol symname has been defined to an illegal value by the 
file name. This occurs for several reasons, some general and 
some specific to the individual symbols. For example, most 
symbols cannot be defined to zero and mapped loadable drivers 
cannot reference SINTSV. 

VMR -- INTERRUPT VECTOR ALREADY IN USE 

A driver interrupt vector does not point to one of the nonsense 
interrupt entries in the system image. 

VMR ~- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE name 

The driver had an invalid data base value at offset xxxx relative 


to the symbol SddDAT. (See the RSX-11M Guide to Writing an I/0 


Driver.) 


VMR -- INVALID INTERRUPT VECTOR 

The interrupt vector address specified in the driver data base 
was too high for the current system image. 

VMR -- INVALID RECORD ADDRESS FOR FILE name 

An attempt was made to write outside of the system image file or 
to write beginning at a byte boundary. The most frequent cause 
of this is a corrupted system image or an STB file that does not 
Match the system image. 

VMR -- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 

The system generation option to support loadable device drivers 
was not chosen for the system image. 

VMR -- NO POOL SPACE 

The required amount of pool space was not available in the system 
image. 

VMR -- PARTITION BUSY 

The user-controlled partition or subpartition into which the 
driver was to be loaded was already occupied, or there was not 
enough room in a system-controlled partition. 

VMR -~ PARTITION name IS A COMMON 

An attempt was made to load a device driver into a common 


partition. A device driver cannot be loaded into a common 
partition. 
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VMR -- PARTITION NOT IN SYSTEM 

The partition specified either in the LOAD command or at_ task 
build was not in the system image. 

VMR -- SPECIFIED PARTITION TOO SMALL 

The partition into which the driver was to be loaded was not 
large enough to contain it. 

VMR -~ SYMBOL symname IS DOUBLY DEFINED BY FILE name 

The symbol symname is defined twice by the file name. Duplicate 
symbols are illegal. 

VMR -- SYMBOL symname IS UNDEFINED IN FILE name 

The symbol symname was found in the file name, but it was not a 
symbol definition. 

VMR -- TASK AND PARTITION BASES MISMATCH 

The base address of the partition into which the driver was to be 
loaded did not match the base address of the partition address 


for which the task was built. This message applies to unmapped 
system images only. 
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LOGICAL UNIT NUMBERS LUN 


The LUN command displays at the entering terminal the static LUN 
assignments for a specified task. (Static assignments are those 
recorded in the task's disk-image file.) The display consists of a 
list of physical device units in one column, with the corresponding 
LUNs in an adjoining column. This command is valid for a virgin 
system only. It is not accepted for a saved system image. 


The format of the LUN command is: 


LUN[S] taskname 


Example: 


VMR>LUN XKE 
SY0: 
SY0O: 
CLO: 
TT3: 
TT3: 
DKO: 
TT3: 


SID OTR WD 


The display shows static assignments for LUNs 1 through 7 as 
recorded in the task-image file header; no other LUNs are 
statically assigned to the task XKE. 
Command Error Messages: 
VMR -- ILLEGAL OPERATION FOR SAVED SYSTEM 
The LUN command can only be issued for a virgin system image. 
VMR -- NO LUNS 
The task that is the argument of the LUN command did not have any 


logical units. This is not an error message; it merely 
indicates that there were no assignments to display. 
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PARTITION DEFINITIONS PAR 


The PAR command displays on the entering terminal a description of 
each memory partition in the system image. 


The display consists of five columns that specify: 


Partition name, 

Partition base address (octal), 

Partition size (octal), 

- Partition kind, main partition (MAIN) or subpartition (SUB), 
and 

5. Partition type: 


&m WD FE 
e e e 


TASK for user-controlled, 

COM for common, 

DEV for device registers, 

SYS for system-controlled, 

(taskname for task region), 

DYNAMIC for dynamically created region, or 
DRIVER for region occupied by a loadable driver. 


COM partitions are used for re-entrant libraries and common data 
areas. DEV partitions allow tasks to communicate with specific device 
registers, such as the UDC-1l and ICS/ICR-11 industrial control 
subsystems. See the RSX-11M Operator's Procedures Manual for a 
description of system- and user-controlled partitions, as well as 
subpartitions. Dynamic and task regions are defined in the RSX-11M 
Executive Reference Manual. See the description of the VMR LOAD 
command for information concerning loadable drivers. 


The format of the PAR command is: 


PAR[TITIONS ]} 


Examples: 
Name Base Size Kind Type 


VMR> PAR 

LDR 000000 000000 MAIN TASK 

SYSPAR 110000 010000 MAIN TASK 

FCPPAR 120000 026000 MAIN TASK 

DRVPAR 146000 026000 MAIN SYS 
146000 007700 SUB DRIVER - TT: 
155700 002100 SUB DRIVER — DB: 
160000 002700 SUB DRIVER - DM: 
162700 001000 SUB DRIVER —- DS: 
163700 001200 SUB DRIVER - DK: 
165100 001100 SUB DRIVER - DT: 
166200 001200 SUB DRIVER - DX: 
167400 001000 SUB DRIVER ~- LP: 
170400 000100 SUB DRIVER - NL: 
170500 003300 SUB DRIVER - MM: 

GEN 174000 200000 MAIN SYS 
174000 040000 SUB (...SAV) 
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Name Base Size Kind Type 


VMR>PAR 

LDR 000000 000000 MAIN TASK 
GEN 100000 360000 MAIN SYS 

TPSPAR 460000 240000 MAIN SYS 

TPMLIB 720000 020000 MAIN COM 

TSTLIB 740000 010000 MAIN COM 

MESS 750000 010000 MAIN COM 
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REASSIGN REA 


The REASSIGN command allows the operator to reassign a task's Logical 
Unit Numbers (LUNs) from one physical device-unit to another. The 
reassignments affect only the static assignments recorded in the 
task's disk image file. 


The command does not affect a memory-resident task. Hence, REASSIGN 
has no effect on the assignments for a task that is fixed or loaded in 
memory. 


The format of the REASSIGN command is: 


REA[SSIGN] taskname lun nud: 


where: 
lun is the logical unit number 
nud is the new device-unit, which can be a physical, 


logical, or pseudo device. 


Examples: 
VMR>REA JOE 3 TTO: 


Reassign LUN 3 of task JOE to device TT0:. 


VMR>REA BILL 2 TT1: 


Reassign LUN 2 of task BILL to device TTl:. 


VMR>REA TEST 3 XX: 


Reassign LUN 3 of task TEST to logical device XX:. 


Command Error Messages: 
VMR -- ILLEGAL OPERATION FOR SAVED SYSTEM 
The REASSIGN function is not allowed for a saved system image. 
VMR -- LUN OUT OF RANGE 


An attempt was made to reassign a LUN that was greater than the 
maximum number of LUNs allocated during task build. 
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REDIRECT RED 


The REDIRECT command allows the operator to redirect all I/O requests 
directed to one physical device-unit to another physical device-unit. 


Note that an attached device and the device TI: cannot be redirected. 
In addition, one pseudo device cannot be redirected to another pseudo 
device. 


The format of the REDIRECT command is: 


RED[IRECT] nud:=old: 


where: 
nud: is the new device-unit to which requests will be 
redirected. 
old: is the old device-unit from which requests have been 


directed. 


Examples: 
VMR>RED TT3:=TT6: 


Redirect all I/O requests for device TT6: to device TT3:. 


VMR>RED TT:=LP: 


Redirect all I/O requests for device LPO: to device TTO:. 


Command Error Messages: 
VMR ~- CIRCULAR REDIRECT ERROR 


The attempt to redirect a device would result in a circular list 
of redirections. 


VMR -- DEVICE NOT REDIRECTABLE 


An attempt was made to redirect a device that cannot be 
redirected. 


VMR -- DEVICE ddnn: NOT IN SYSTEM 


The specified device in the REDIRECT command was not known to the 
system (did not exist in the device tables). 


VMR -- OLD DEVICE ATTACHED 


An attempt was made to redirect an attached device. 


5-30 
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VMR -- PSEUDO DEVICE REDIRECT ERROR 

An attempt was made to redirect one pseudo device to another 
pseudo device. 

VMR -~- TI REDIRECT ERROR 


An attempt was made to redirect the pseudo device fTI:. This 
device may not be redirected. 
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REMOVE REM 
The REMOVE command allows you to delete a task name from the System 
Task Directory (STD) and thereby remove the task from the system 
image. Removing a task from the system image makes the task unknown 
to the system. The action resulting from this command is the 
complement of INSTALL. 

The REMOVE command cannot remove an active task from a saved system. 
An example of such a task is the SAVE task; an attempt to remove SAVE 
from a saved system results in an error. The message TASK ACTIVE is 
displayed. 

The format of the REMOVE command is: 


REM[OVE] taskname 


Example: 
VMR>REM SCAN 
Remove the task named SCAN from the system image. The task-image 
file remains unaffected. 

Notes: 


e If a task that is the object of a REMOVE command is fixed, the 
command automatically unfixes the task from the system image. 


@e REMOVE automatically cancels all time-based schedule requests 
for the specified task. 


e REMOVE cannot deallocate any receive-by-reference and 
receive-data packets for the task. 
Command Error Message: 
VMR -~ RECEIVE DATA OR BY REFERENCE LIST NOT EMPTY 


A task with entries in its receive queues may not be removed from 
the system image. 


RUN 


The RUN command 
cause a task to 


e Started 
e Started 
e Started 


e Started 


initiates 
be: 


one clock 
at a time 


at a time 
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RUN 


the execution of a task. The command can 


tick after system boot, 
increment from the system image time, 


increment from clock unit synchronization, 


at an absolute time of day. 


All these options, are available with or without rescheduling. 


RUN has four format variations, as described below. 


The formats of the RUN command are: 


1. Run one clock tick after system boot. 


RUN taskname [/RSI=magu] [/UIC=[uic] ] 


where: 


taskname 


RSI 


UIC 


is a l- to 6-character taskname. 


is the reschedule interval. The format is 
the same as for dtime, which is detailed 
below under format 2% The reschedule 
interval specifies how often the task is to 
be rerun. Thus, each time the specified 
interval of time lapses, an initiation 
request is made for the specified task. 


Default: no rescheduling. 


is the UIC that has the format [g,m] where g 
and m represent the group and member numbers 
respectively; legal group and member numbers 
range from 1 through 377(8). The square 
brackets are required syntax. This is the 
UIC under which the task is requested. The 
UIC determines which files the task may 
access. 


Default: the value established for terminal 
CO:. 


2. Run at a time increment from the system image time. 


RUN taskname dtime [/RSI=magu] [/UIC=[uic] ] 


where: 


taskname 


dtime 


is a l- to 6-character taskname. 


is the time at which the task is initiated in 
time units from current system image time. 
It follows the form magu. 
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A time parameter consists of two fields: 
a. A magnitude field, and 


b. A units field. 


where: 
mag is the magnitude 
u specifies time units as one of the 


following letters: 


T 
S 
M 
H 


The legal value of the magnitude is’ related 
to the value of the units field, which is 
encoded as: 


T for ticks. A tick is a clock 
interrupt, and the rate at which 
interrupts occur depends on the type 
of clock installed in the system. 


For a line frequency clock, the tick 
rate is either 50 or 60 per second, 
corresponding to the line frequency. 
For a programmable clock, a maximum 
of 1000 ticks per second is 
available. (The frequency is 
selected at system generation.) 
Ss for seconds. 
M for minutes. 
H for hours. 
The magnitude is the number of units to be 
clocked, but the magnitude value cannot 
exceed 24 hours in the specified units. 


Units = T. Any positive value is valid 
(maximum of 15 bits). 


Units = S. Any positive value is valid 
(maximum of 15 bits). 


Units = M. The maximum magnitude is 


1440(10). 
Units = H. The maximum magnitude is 
24(10). 
RSI See Format 1, above. 
UIC See Format 1, above. 
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3. Run at a time increment from clock unit synchronization. 
The task start-time is determined by computing the number of 
ticks until the next time unit's occurrence (hour, minute, 
second, tick) and then adding on the number of ticks for’ the 
specified time increment to elapse. 
Run taskname sync [dtime] [/RSI=magu] [/UIC=[uic] ] 


where: 


taskname is a l- to 6-character taskname. 


sync H = synchronize on the next hour; 
M = synchronize on the next minute; 
S = synchronize on the next second, and 
T = synchronize on the next tick. 

dtime is as defined in Format 2, above; dtime, if 
present, is added to the synchronization unit 
to produce the actual run time for running 
the task. 

RSI See Format 1, above. 

UIC See Format 1, above. 


4. Run at an absolute time of day. 


RUN taskname atime [/RSI=magu] [/UIC=[uic] ] 


where: 

taskname is a l- to 6-character taskname. 

atime is the absolute time of day when this’ task 
will be initiated. Input format is hh:mm:ss. 
hh = hours (decimal assumed); 
mm = minutes (decimal assumed), and 
ss = seconds (decimal assumed). 

RSI See Format 1, above. 

UIC See Format 1, above. 


Examples: 


Note: 


>RUN XKE 15M 
Run task XKE 15 minutes from the current system image time. 
>RUN XKE 15M/RSI=90S/UIC=[3,1] 


Run task XKE 15 minutes from the current system image time, 
rescheduling it every 90 seconds, with a UIC code of [3,1]. 


e The correct value to be inserted in the clock for forms 2 
through 4 is computed from the current value of the system 
time stored in the system image. Thus, the system image time 
must be set before any RUN requests are made or they may not 
occur at the correct time after the system is booted. 
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Command Error Messages: 
VMR -~ INVALID TIME PARAMETER 


A specified time field was incorrect. 
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SAVE SAV 


The VMR SAVE command writes the image of a system onto a_ sequential 
medium in bootstrappable format. This command allows you to copy an 
RSX-11S or foreign system (see /IM switch) onto a tape or floppy disk 
that you can transport to another system and bootstrap using a 
hardware bootstrap or the /BO switch in PRESRV. 


System images created with the SAVE command on all media, except paper 
tape, are in a format compatible with the logical tape format in 
PRESRV. Thus, any of PRESRV's logical tape operations can be 
performed on system images created with the SAVE command. System 
images created by the SAVE command always start at the beginning of 
the medium. 


On paper tape, system images are created in absolute loader format and 
must be bootstrapped with the absolute loader. 


The format of the SAVE command is: 
SAV[E] ddnn: [label] 
where: 


ddnn: specifies the device-unit onto which the system image 
is to be written. Valid devices are: 


CT: Tape cassette, 

DT: DECtape, 

DX: Flexible diskette, 

MM: TE/TU16/TU45 magtape, 

MT: TE/TU10O/TSO3 magtape, and 
PP: Paper tape. 


label is the file label name that must be specified ffor all 
secondary media except paper tape. It consists of from 
one to twelve alphanumeric characters. 


Example: 
VMR>SAV MT:MYSYS 


In the example above, the system image is written onto MT: in 
bootstrappable format. System changes made by other VMR commands 
are also saved with the system image. 


Notes: 


e When the /LI command is used in PRESRV to list a medium (other 
than paper tape) containing a system image created with the 
SAVE command, each system image causes a line to be printed 
which contains the following: VM (for VMR), indicated as the 
source device, the label specified in the SAV command line, a 
block size of 512, the number of 512-byte blocks in the system 
image (excluding boot and label blocks), and the date and time 
that the system was saved. 


e When RSX-11S systems are saved on paper tape (without the /IM 
Switch specified at VMR initiation time), the last 1000(8) 
bytes of the system image are not written out. This allows 
space to accommodate the absolute loader. When the /IM switch 
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has been specified with the system's file name, the 


entire 


system image is written out to paper tape. In this case, it 
is your responsibility to ensure that the system image is not 


so large that it overlays the Absolute Loader. 


e When saving a system on paper tape, contiguous blocks’ that 
contain zero only and that begin on a 32-word address are 
compressed into a 2-word descriptor. This compression 
significantly reduces both the amount of paper tape required 


and the time expended to create the tape and to read 


it into 


memory. After the entire image has been loaded into memory, a 
short routine zeroes the appropriate blocks of memory before 


passing control to the bootstrapped system. 


e When bootstrapping systems on media other . than paper 


tape, 


regardless of the size of the system image, the last 1000(8) 
bytes of physical memory are not copied to accommodate the 


bootstrap. 


e Systems saved on a TE/TU10/TS03, 9-track magtape drive can be 


booted from a TE/TU16 drive, and vice-versa. 


@e When the /IM switch has been specified with the system file 
specifier, the SAVE command always uses a bootstrap that does 


not enable memory management. 


e The maximum memory size of a mapped system is 124K words. For 
physical and practical limitations, the SAVE command imposes 


maximum sizes on saved images in mapped systems’ for 


certain 


devices. If a mapped system is saved, whose memory size is 
greater than the maximum size imposed by the SAVE command for 
the specified device, only the amount of memory equal to the 
maximum size (starting at physical location 0) is’ saved; no 
diagnostic message is issued. The devices for which the SAVE 
command imposes a maximum size on saved system images are: 


Paper tape punch (PP) - 28K words, 
Flexible disk (DX) -—- 123K words, and 


Cassette tape (CT) - 28K words. 


e None of the bootstraps require that the target RSX-11S 


have a driver for the bootstrap device. 


Command Error Messages: 
VMR -- DEVICE ddn: NOT IN SYSTEM 
The specified device does not exist on the host system. 
VMR ~~ ILLEGAL DEVICE VOLUME 


The specified device was other than one of the valid 
specified above. 


VMR ~- I/O ERROR ON OUTPUT DEVICE 


An I/O error was encountered on the output device while 
the system image. 


system 


devices 


writing 
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SET SET 


The SET command allows you to alter a number of system-wide 
characteristics. The following list describes all the available 
options. The text in parentheses specifies keywords associated with 
the options. The SET command allows you to: 


e Display the status (determined by the keyword specified) of 
all terminals. 


e Establish device characteristics for any device in the system 
(BUF, CRT, ESCSEQ, LA30S, LA180S, LOWER, REMOTE, SPEED, and 
VTO5B), 


e Establish the default UIC for any terminal in the system 
(UIC), 


e Set the status of any terminal in the system (PRIV or SLAVE), 
e Create partitions Or subpartitions (MAIN and SUB), 

e Add space to the system dynamic memory (POOL), 

e Enable write check on devices that support it (WCHK). 


Improper use of the SET command can result in a situation in which 
privileged operator input is not accepted. The following two 
situations should be avoided: 


e There are no non-slave, privileged terminals in the system. 
Non-privileged terminals cannot enter privileged commands. 
Slaved terminals cannot enter unsolicited input to MCR. See 
the description of the /SLAVE keyword below. 


e The buffer length of all non-slave, privileged terminals is 
shorter than 14 bytes. In this case, the terminal buffer is 
too short to enter many important commands required to 
continue system operation or alter the status of other 
terminals. See the description of the /BUF keyword below. 


A number of SET command options (CRT, ESCSEQ, LOWER, and WCHK) require 
Executive features that must be included at system generation. If 
support for a specified option has not been generated into the system 
image, the SET command has no effect. 

Only one keyword per command is permitted. Most keywords can be 
prefixed by NO to negate or disable the function of the keyword. 


Exceptions are BUF, POOL, SPEED, and UIC; VMR returns a syntax error 
whenever NO precedes one of these keywords. 


The format of the SET command is: 


SET /keyword=values 


Device Characteristics Keywords: 
/BUF=dev: [size] 


/CRT[=ttn: ] 
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/ESCSEQ [=dev: ] 


/LA30S [=dev: ] 


/LA180S [=devs: ] 


/LOWER [=dev: ] 


/PRIV [=dev: ] 


/REMOTE [=dev: ] 


/SLAVE [=dev: ] 


/SPEED=dev: [recv:xmit] 


/UIC [=uic[:dev:] ] 


/VTO5B [=dev: ] 


/WCHK [=dev: ] 


Keyword Definitions: 


BUF 


CRT 


NOCRT 


ESCSEQ 


/BUF=dev: [size]. Set or display the default buffer 
size of the specified device. If the buffer size is 
omitted, this keyword causes the current size to be 
displayed. The specified size must be greater than 0 
and less than or equal to 255 decimal (for a terminal, 
the buffer size must be greater than or equal to two). 
BUF is particularly useful for defining line printer 
width (80 or 132 columns). 


/CRT[=dev:] where dev: is a cathode ray tube (CRT) 
terminal. The CRT keyword defines the terminal as a 
CRT and enables the backspace deletion option. Typing 
the RUBOUT or DELETE key moves the printing position 
one space to the left and erases any character 
displayed in that position. 


When the keyword omits =dev:, VMR displays all the 
devices that are defined as CRTs. 


/NOCRT[=dev:] where dev: is a cathode ray tube (CRT) 
terminal. The NOCRT keyword deletes the CRT status of 
the specified device and disables the backspace 
deletion option. 


When the keyword omits =dev:, VMR displays all the 
terminals that are not defined as CRTs. 


/ESCSEQ[=dev:] where dev: is a terminal. The ESCSEQ 
keyword enables the recognition of escape sequences 


from the specified terminal. The terminal driver 
treats the ESC character as the beginning of an escape 
sequence rather than as a line terminator. See the 


RSX-11M I/O Drivers Reference Manual for further 
information about escape sequences. 


When the keyword omits =dev:, VMR displays all the 
terminals that recognize escape sequences. 


NOESCSEQ 


LA30S 


NOLA308S 


LA1808S 


NOLA1805S 


LOWER 


NOLOWER 


PRIV 


NOPRIV 


REMOTE 


NOREMOTE 
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/NOESCSEQ[=dev:] where dev: is a terminal. The 
NOESCSEQ keyword disables the recognition of escape 
sequences at the specified terminal. 


When the keyword omits =dev:, VMR displays all the 
terminals that do not support the recognition of escape 
sequences. 


/LA30S [=dev:]. Establishes the specified terminal 
device as an LA30S and generates fill characters 
required for an LA30S. If =dev: is omitted, all 
terminals defined as LA30S are displayed. 


/NOLA30S [=dev:]. Resets the terminal to a device other 
than an LA30S. If =dev: is omitted, all non-LA30S 
terminals are displayed. 


/LA180S [=dev:]. Establishes the specified terminal 
device as an LA180S and causes the terminal driver to 
suppress normal conversion of form feeds to 8 line 
feeds. If the keyword omits =dev:, all terminals 
defined as LA180S are displayed. 


/NOLA180S [=dev:]. Resets the terminal to a non-LAl180S 
device. If the keyword omits =dev:, all non-LA180S 
terminals are displayed. 


/LOWER[=dev:]. Specifies that lower-case characters 
are not to be converted to upper case when they are 
received from the specified terminal. If =dev: is 
omitted, all terminals for which lower-case characters 
are not converted are displayed. 


/NOLOWER[=dev:]. Resets the terminal characteristics 
so that lower-case characters received on input are 
automatically converted to upper case and echoed as 
upper case. Absence of =dev: results in the display 
of all terminals for which conversion to upper case is 
specified. 


/PRIV[=dev:]. Sets the specified terminal to 
privileged status. If =dev: is omitted, VMR displays 
all privileged terminals. 


/NOPRIV[=dev:]. Sets the identified terminal to 
nonprivileged status. Absence of =dev: results in a 
display of all nonprivileged terminals. 


/REMOTE [=dev:] where dev: is a terminal with a line to 
a DZ11 multiplexer. The keyword declares that the 
specified terminal is connected to a modem and can be 
connected by means of a dial-up network. 


When the keyword omits =dev:, VMR displays all remote 
lines (including DH11 lines). 


/NOREMOTE [=dev:] where dev: is a line to a D2@ll 
multiplexer. The NOREMOTE keyword establishes’ the 
terminal's line as a local line not connected to a 
modem. 


When the keyword omits =dev:, VMR displays all local 
lines (including DL11, DH11, DJ1l1, and DZ11 
multiplexers). 


* 


SLAVE 


NOSLAVE 


SPEED 


UIC 


VTO5B 


NOVTO5B 


WCHK 
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/SLAVE [=dev:]. Establishes the specified terminal as 
one that can enter data only if it is solicited from a 
task; thus, the specified terminal always rejects 
unsolicited input (other than CTRL/O, CTRL/Q, and 
CTRL/S). Absence of dev: results in the display of 
all terminals currently classified as slaved. 


/NOSLAVE [=dev:]. Sets the specified terminal to 
nonslave status. Absence of =dev: results in the 
display of all nonslave terminals. 


/SPEED=dev: [recv:xmit]. Establishes the receive and 
transmit baud rate for terminals attached to the system 
through a DH11 or DZI1 multiplexer. The argument 
"recv" is the baud rate at which characters are input 
to the computer from the terminal; and "xmit" is_ the 
baud rate at which the computer outputs characters to 
the terminal. Both must be specified in setting the 
speed. If neither is specified, the current settings 
are displayed. 


Valid baud rates for the DH11 are: 0, 110, 150, 200, 
300, 600, 1200, 1800, 2400, 4800, 9600, A 
(user-specified baud rate A), and B- (user-specified 
baud rate B). 


Valid baud rates for the DZ11 are: 0, 110, 150, 300, 
600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, and 
9600. The receive and transmit baud rates for the DZ1l 
must be the same; the DZ11 does not support split 
speeds. 


/UIC[=uic[:dev:]]. The specified UIC is established as 
the default UIC for the entering terminal unless dev: 
is specified. If you specify dev:, the default UIC is 
set for that terminal. All tasks run from the terminal 
are run with the UIC of the terminal, except in a 
Multiuser protection system. In such a_ system, a 
privileged user can override the terminal UIC with the 
UIC switch in the RUN command. Further, external MCR 
function tasks* are requested with this UIC. 


If a UIC is not specified, the current UIC is 
displayed. If only dev: is specified, the UIC for the 
specified terminal is displayed. 


/VT05B[=dev:]. Sets the specified terminal as a VTO5B 
(a 2400 baud VT05) and generates fill characteristics 
of a VTO5B. If =dev: is omitted, all terminals 
classified as VTO5B are displayed. 


/NOVTO5B[=dev:]. Resets the terminal to other than a 
VTO5B. If =dev: is omitted, all terminals classified 
as non-VT05B terminals are displayed. 


/WCHK [=dev:]. Specifies for all Files-ll devices 
except Dx: and DL: and magnetic tape (MM: and MT:) 
that all writes are to be followed by a write check. 
This feature provides high reliability for data 
transfers to the specified disk. Executive support for 
write check is a SYSGEN option and must be selected for 


These tasks are the MCR MOUNT, INSTALL, DMO, and UFD commands 


(which run as tasks) and all system-supplied software. 
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this command to have any effect. If =dev: is omitted, 
all Files-1ll disk drives with write check enabled are 
displayed. 

NOWCHK /NOWCHK [=dev:]. Specifies that write check is to be 
disabled for the specified device. If =dev: is not 
specified, all disks that support write check, but have 
it disabled are displayed. 

Examples: 


>SET /BUF=LP0: 
BUF=LP0:132. 


Display the current buffer size of LPO: 


>SET /BUF=TT1:40. 


Set TTl: buffer size to 40(10). 


>SET /CRT=TT3: 

Enable the backspace deletion option on the display terminal 
identified by TT3:. 

>SET /CRT 

CRT=TT3: 


Display all terminals that support the backspace deletion option. 


>SET /ESCSEQ=TT3: 

Establish terminal TT3: aS a terminal that can send and receive 
escape sequences. 

>SET /ESCSEQ 

ESCSEQ=TT3: 


Display all terminals that can send and receive escape sequences. 


>SET /NOESCSEQ=TT3: 

Disable support of escape sequences on TT3:. 
>SET /LA30S=TT2: 

>SET /LA30S 

LA30S=TTO: 

LA30S=TT2: 

Set TT2: as an LA30S. 

Display all LA30S terminals. 

>SET /NOLA30S=TTO: 


Set TTO: to other than an LA30S terminal. 
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>SET /PRIV=TTO: 

Set TTO: to a privileged terminal. 
>SET /PRIV 

PRIV=TTO: 

PRIV=TTI1: 


Display all privileged terminals. 


>SET /REMOTE=TT21: 
Set the terminal line corresponding to TT21: as a remote dial-in 


line. The line must be connected to a DZ11 multiplexer. 


>SET /REMOTE 

REMOTE=TT1: 

REMOTE=TT2: 

REMOTE=TT3: 

REMOTE=TT4: 

REMOTE=TT21: 

Display all terminals that are currently set as remote dial-in 
lines. TTl:, TT2:, TT3:, and TT4: are DH11l lines; TT21: isa 
DZ11 line. 

>SET /SLAVE=TT3: 

Set TT3: to a slave terminal. 

>SET /VTO5B 

VTO5B=TT4: 

VTO5B=TT5: 

VTO5B=TT6: 


Display all VTO5B terminals. 


>SET /WCHK=DK1: 
Enable write check on DKl1:. 
Memory Allocation Keywords: 
/MAIN=pname[:base:size:type] 
/NOMAIN=pname 
/SUB=mname:pname[:base:size] 
/NOSUB=mname : pname 


/POOL[=top] 


These keywords are used as follows: 


MAIN The MAIN keyword establishes a main partition. 


pname 


:base 


:size 


:type 
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is the l- to 6-character alphanumeric partition name. 


is the physical base address of the partition specified 
as a number of 64-byte blocks. 


is the size of the partition specified as a number of 
64-byte blocks. The maximum size is 32K minus 32 words 
for a task, common, main, or sub partition unless’ the 
system has memory management. 


is TASK for a user-controlled task partition, 
is SYS for a system-controlled task partition, 
is COM for a common partition, or 


is DEV for a common partition mapping into the device 
registers. 


User-controlled and system- controlled task partitions 
are allocated for user tasks and loadable drivers. 
Common partitions are used for resident libraries and 
common blocks. Device partitions are used by 
nonprivileged tasks to access device registers in the 
external page, such as those for the UDC-1l and 
ICS/ICR-11. 


Base and size may be entered in any of the following formats; 
where nnnn iS a number to which a multiplication factor is 
applied to determine the value used. 


Format 


nnnn 
nnnn. 
nnnk 

nnn.K 


Calculated Value 


Octal (nnnn*100) 
Decimal (nnnn.*64.) 
Octal K (nnn*4000) 
Decimal K (nnn.*2048.) 


Valid ranges of calculated values are: 


Octal 0<=base<177777 0<size<2000 
Decimal 0.<=base<65535 0.<size<1024. 
Octal K OK<=base<3777K OK<size<40K 
Decimal K 0.K<=base<2047.K 0O.K<size<32.K 


For system-controlled partitions, size may range from 0 to 


1920. 


K or any valid representation of these limits. 


Example: 


Any of the following inputs for size will allocate a 1920. 


byte 


40 
32. 
1K 
1.K 


partition. 


If the command does not specify base, size, and type, VMR 
displays the values of these parameters for the named 
partition. If the named partition is a main partition, VMR 


also 


displays the parameters of all its subpartitions. 


NOMAIN 


SUB 


NOSUB 
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is the keyword that eliminates the named partition from the 
system. 


is the keyword that establishes a subpartition. 
Subpartitions may only be established in user-controlled main 
partitions. 


mname is the l- to 6-character main partition name. The 
subpartition being defined becomes a subpartition 
in the named main partition. 


:pname is the 1- to 6-character subpartition name. The 
subpartition being defined becomes a subpartition 
of the main partition specified in mname. 


sbase is the physical base address of the subpartition, 
specified as a number of 64-byte blocks. 


:size is the size of the subpartition, specified as a 
number of 64-byte blocks. 


Base and size may be entered in any of the following 
formats; nnnn is a number to which a multiplication factor 
is applied to determine the value used. 


Format Calculated Value 

nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnkKk Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of values are: 


Octal 0<=base<10000 0<size<2000 
Decimal 0.<=base<4096. 0.<size<1024. 
Octal K OK<=base<200K OK<size<40K 
Decimal K 0.K<=base<2047.K 0O.K<size<32.K 
Example: 


Any of the following inputs for size will allocate a 2048. 
byte subpartition. 


If base and size are omitted, the current values will be 
displayed for the named subpartition. 


is the keyword that eliminates the named subpartition from 
the system. 
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Notes: 
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is the keyword that increases the size of the dynamic storage 
region. 


top is the first location in memory used for partition 
allocation. The location is specified in units of 
64-byte blocks. It can be given in octal or 
decimal. If top is not given, the system prints 
out the current top of memory, the size of the 
longest block of pool space in words, and the 
total number of words in the pool. 


The format is: 
POOL = top:max:total 


where top is given in units of 64-byte blocks. 
Max and total are in decimal words. 


If a partition currently hosts installed tasks or loaded 
drivers, and a command (for example, /NOMAIN or /NOSUB) 
attempts to eliminate the partition, VMR rejects the command. 


A command that eliminates a main partition also eliminates all 
its subpartitions. A command that eliminates a specified 
subpartition eliminates only that specified subpartition. 


If a command attempts to eliminate a main partition that has 
subpartitions in which tasks are installed or drivers loaded, 
the system rejects the command until those tasks are removed 
from the subpartitions. 


When defining a partition (main or sub) the name must not 
already be defined as a partition. In addition, a main 
partition can not overlap any other main partition; nor can a 
subpartition of a main partition overlap any other 
subpartition of the main partition. 


The numeric value convention applies to all the SET command 
numeric values. 


The address specified with the POOL command must be lower than 
the base address of the first partition in the system with the 
exception of partition LDR. 


Once space has been allocated to the dynamic storage region, 
the space can never be recovered for use in partitions. 


System-controlled partitions can not include subpartitions 
explicitly defined by the SET command. An attempt to define 
subpartitions of system-controlled partitions in this way will 
be rejected. The Executive dynamically defines subpartitions 
of a system-controlled partition as needed to load tasks and 
drivers in the system-controlled partition. 


When the highest memory addresses of a system are allocated to 
a system-controlled partition, the size of the partition is 
modified automatically to reflect the amount of memory present 
when the system is bootstrapped. 
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Examples: 

>SET /MAIN=SYSPAR: 420:140:TASK 

Define a main partition called SYSPAR as a_euser-controlled 
partition whose base address is 42000(8) and whose length is 
14000(8) bytes. 

>SET /SUB=SYSPAR:MCRPAR: 445:56 

Define a subpartition called MCRPAR of main partition SYSPAR 
whose base address is 44500(8) and whose length is 5600(8) bytes. 


>SET /MAIN=SYSPAR 

MAIN=SYSPAR: 0420:0140: TASK 

SUB=SYSPAR:MCRPAR: 0445:0056 

Display the parameters of the main partition SYSPAR and all of 
its subpartitions. 


>SET /NOSUB=SYSPAR:MCRPAR 


Eliminate subpartition MCRPAR. 


>SET /NOMAIN=SYSPAR 


Eliminate main partition SYSPAR. 


SET /MAIN=GEN:1000:6000:SYS 

Define a main partition called GEN as a_e system-controlled 
partition whose base address is 100000(8) and whose length is 
600000(8) bytes. 

>SET /POOL=420 


(No user defined partition can be to 42000(8). 


>SET /POOL 
POOL=0420:150: 430. 
The first available location for user partitions is 42000; the 
longest free block is 150. words, and the total of all pool space 
is 430. words. 
Command Error Messages: 
VMR -- ALIGNMENT ERROR 
An attempt was made to create a partition, but the base address 


or size conflicted with existing partitions or physical memory 
size. 
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VMR -- DEVICE NOT VARIABLE SPEED MULTIPLEXER 


An attempt was made to set the baud rate for a terminal that was 
not attached to a DH11 or DZ11 multiplexer. 

VMR -- DEVICE NOT TERMINAL 

An attempt was made to set terminal characteristics for a 
nonterminal device. 

VMR -- INVALID SPEED 

The multiplexer line specified does not support the requested 
speed; or the command specified unequal receive and transmit 
speeds for a DZ11. The DZ11 does not support split speeds. 

VMR -- LINE NOT D211 

The command attempted to set to remote a line that was not 
attached to a DZ11 multiplexer. 

VMR -- NON EXISTENT MEMORY 


An attempt was made to define a partition in nonexistent memory. 


VMR -- PARTITION ALREADY EXISTS 

An attempt was made to define a partition with a name already in 
use e 

VMR ~~ PARTITION BUSY 

A task or a driver is installed or loaded in the specified 
partition or subpartition. 

VMR -- POOL LINK ERROR AT xxxx BLOCK=yyyy z22zz 

When SET /POOL traced the pool linkage, it detected an error at 
location xxxx in the system image. The contents of xxxx is yyyy 
and the contents of xxxx+2 iS zzzz. 

VMR -- SPACE USED 

An attempt was made to create a partition or subpartition in a 
storage area already occupied. 

VMR -- TOO MANY SUBPARTITIONS 


An attempt was made to define more than seven’ subpartitions. A 
main partition is limited to a maximum of seven subpartitions. 
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VMR -- UNKNOWN MAIN PARTITION 

An attempt was made to define a subpartition of a nonexistent 
main partition. 

VMR -- WRITE CHECK NOT SUPPORTED FOR DEVICE 

An attempt was made to enable write check on a device that does 


note support it. Write check is currently supported for all 
disks except DL: and DxX:. 
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TASKLIST TAS 


The TASKLIST command displays a description of each installed task on 


the entering terminal. The display contains in columnar form, from 
left to right: 

l. Task name, 

2. Task version identification, 

3. Partition name, 

4. Task priority, 

5. Size of task in bytes (octal), 

6. Load device identification, 

7. Disk address logical block number (octal), in a virgin system 


image task file identification in a saved system image, 
and 


Task memory state. 


or 


The format of the TASKLIST command is: 


TAS [KLIST] 


Example: 

VMR>TAS 

- LDR. LDR 248. 000000 LBO:-00000000 FIXED 
TKTN 03 SYSPAR 248. 010000 LBO:-00657407 
RMDEMO MO3 GEN 225. 013400 LBO:-00662334 
MTAACP 0005 GEN 200. 012600 LBO:-00677004 
F11MSG VOO10 SYSPAR 200. 010000 LBO:-00666657 
~»eMCR 02 SYSPAR 160. 010000 LBO:-00657050 
ses5YS Ol GEN 160. 010000 LBO:-00657202 
---HEL Ol GEN 150. 040000 LBO:-00655150 
eabY EOL GEN 150. 040000 LBO:-00655117 
F11lACP MM0234 FCPPAR 149. 026000 LBO:-00724342 
DTAACP MS0234 GEN 149. 010000 LBO:-00667662 
-..DMO 03 GEN 140. 040000 LBO:-00655177 
~.e-INI 03 GEN 140. 040000 LBO:-00655206 
..-MOU 03 GEN 140. 040000 LBO:-00657271 
-.-UFD V0407 GEN 140. 040000 LBO:-00657416 
PMD... 03 PMDPAR 130. 020000 LBO:-00666610 


On a system image generated for on 11/70 with more than 124K 


words of memory, the size field (fifth column) contains 8-digit 
rather than 6-digit numbers. This display is for a virgin system 
image. 
FIXED indicates that the task is fixed in memory. 
VMR>TAS 
- LDR. LDR 248. 000000 LBO:- FILE ID:(0,0) FIXED 
TKTN SYSPAR 248. 010000 LBO:- FILE ID: (2572,11) 
..eMCR SYSPAR 160. 010000 LBO:- FILE ID: (2563,11) 
re as. GEN 160. 010000 LBO:- FILE ID: (2565,11) 
F11ACP FCPAR 149. 026000 LBO:- FILE ID: (2576,11) 
. -DMO GEN 140. 040000 LBO:- FILE ID: (2556,11) 
..-INI GEN 140. 040000 LBO:- FILE ID: (2557,11) 
..-MOU GEN 140. 040000 LBO:- FILE ID: (2567,11) 
+ecUED GEN 140. 040000 LBO:- FILE ID: (2573,11) 
PMD... PMDPAR 130. 020000 LBO:- FILE ID: (2610,12) 
SHF... SYSPAR 105. 010000 LBO:- FILE ID: (2606,11) 
-»- INS GEN 100. 040000 LBO:- FILE ID: (2562,11) 
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-- OAV GEN. 100. 040000 LBO:- FILE ID: (2570,11) 
-- -BAD GEN 100. 040000 LBO:- FILE ID: (6162,34) 
PRT... PMDPR 70. 020000 LBO:- FILE ID: (5210,6) 


- - «BOO GEN 50. 040000 LBO:- FILE ID: (2273,30) 
<esACsS GEN 50. 040000 LBO:- FILE ID: (1066,22) 
~.-PIP GEN 50. 054300 LBO:- FILE ID: (2627,11) 
PSE GEN 50. 031600 LBO:- FILE ID: (5552,4) 
mee se GEN 1. 040000 LBO:- FILE ID: (5013,4) 
The above display is from a saved system. It differs from a 


virgin system in two ways: the task version is not displayed and 
the file id of the task file, rather than the logical block 
number is displayed. 


TIME 

The TIME 
es 
es 


eD 


The forma 


TIM[ 


TIM[ 
where: 
hrs 
mins 
secs 
ml 


m2 


Examples: 


>TIM 
10:2 


Disp 


>TIM 


set 
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TIM 
command allows you to: 
et the time of day, 
et the date, or 
isplay the time and date. 
t of the TIME command is: 
E] [hrs:smins[:secs]] [ml/day/year ] 
or 
E] [hrs:mins[:secs]] [day-m2-year] 
hours (range 0-23) 
minutes (range 0-59) 
seconds (range 0-59) (optional) 
numeric representation of month (range 1-12) 
3-letter abbreviation for month 
day (range 1-31) 
year (range 0-99). Year is relative to 1900; thus, 


1977 is entered as 77. 
If the command specifies neither time nor date, it displays 
the current system image time and date. 
If the command specifies the time and date, it sets’ the 
system image clock and calendar. If only the time is 
specified, only the clock is set; if only the date is 
specified, only the calendar is set. 


The time and date can be specified in any order. 


All numeric values are decimal. No terminating period is 
necessary (nor permitted). 


3231 03=NOV-77 


lay the current system image time and date. 


1:30 11/4/77 


the time to 01:30:00 and the date to 04-NOV-77 
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UNFIX UNF 


The UNFIX command allows you to free a fixed task from the system 
image. UNFIX is the complement of the FIX command. 


If a fixed task exits or aborts, it still occupies the system image 
memory of the partition. 


Format: 


UNF [IX] taskname 


Example: 
>UNFIX xke 


Unfix task XKE, freeing the partition in which it resides. 


Command Error Messages: 
VMR -- TASK NOT FIXED 


An attempt was made to unfix a task that was not 
fixed. 
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UNLOAD UNL 


The UNLOAD command removes a loadable device driver from the system 
image. If a device is attached, its driver cannot be unloaded. 


To unload a device driver from the system image, the driver's STB file 
must reside on the same disk and under the same UIC as the system 
image file. 

The UNLOAD command cannot remove a data base from the system image, 
even if the data base was loaded by means of the LOAD command. 


The format of the UNLOAD command is: 


UNL[OAD] dd: 


wheres: 

dd: is a 2-character ASCII device name 
Example: 

VMR>UNL LS: !UNLOAD LPS11 DRIVER (LSDRV) 


Command Error Messages: 
VMR -~- DEVICE ddn: NOT IN SYSTEM 


No such device existed in the system. 


VMR -- DEVICE ddn: IS ATTACHED 
One or more device-units handled by the driver are attached. The 


first such unit is ddn:, therefore, the driver cannot be 
unloaded. 


VMR -- DRIVER BUILT WITH WRONG STB FILE 


The STB file for the driver was not compatible with the current 
Executive. 


VMR -- DRIVER CAN NOT BE UNLOADED 


The UNLOAD command attempted to remove a permanently resident 
device driver (that is, a driver linked to the Executive). 


VMR -- DRIVER NOT LOADED 


The specified device driver in the UNLOAD command was not 
resident in memory. 


VMR -- FILE name HAS ILLEGAL FORMAT 


The driver's STB file contained incorrect object code or data. 
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VMR -- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 

The symbol symname has been defined to an illegal value by the 
file name. This occurs for several reasons, some general and 
some specific to the individual symbols. For example, most 
symbols cannot be defined to zero and mapped loadable drivers 
cannot reference SINTSV. 

VMR -- INVALID RECORD ADDRESS FOR FILE name 

An attempt was made to write outside of the system image file or 
to write beginning at a byte boundary. The most frequent cause 
of this is a corrupted system image or an STB file that does not 
Match the system image. 

VMR ~~ LOADABLE DRIVER SUPPORT NOT IN SYSTEM 

The system generation option to support loadable device drivers 
was not chosen for the current system image. 

VMR -~ SYMBOL symname IS DOUBLY DEFINED BY FILE name 

The symbol symname is defined twice by the filename. Duplicate 
symbols are illegal. 


VMR -- SYMBOL symname IS UNDEFINED IN FILE name 


The symbol symname was found in the file name, but it was not a 
symbol definition. 


5.7  VMR ERROR MESSAGE SUMMARY 


All error messages produced by VMR appear in this section in 
alphabetical order. 


VMR ~~ ADDRESSING EXTENSIONS NOT SUPPORTED 


The command tried to install a task with a VSECT (virtual 
section) into a system image that does not support the feature. 


VMR -- ALIGNMENT ERROR 

The command tried to create a partition, but the base address or 
size conflicts with existing partitions or physical memory size. 
VMR -- BASE ADDRESS MUST BE ON 4K BOUNDARY 

The base address of the task is not on a 4K boundary. Applicable 
only to mapped system images. 

VMR ~- BASE MISMATCH COMMON BLOCK <common-name> 


The base address of the partition does not match that of the 
common block. Applicable only to unmapped system images. 
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VMR -- CANNOT FIX A TASK IN A SYSTEM CONTROLLED PARTITION 

This is a restriction of VMR. To fix a task in ae_=e system 
controlled partition, use the MCR FIX command and then SAVe the 
system image. 

VMR -- CHECKPOINT AREA TOO SMALL 

The area allocated for checkpointing in the task image file is 
smaller than the partition into which the task is being 
installed. The system image does not support the dynamic 
allocation of checkpoint space. 

VMR -- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 

This is a warning message. The checkpoint space allocated in the 
task image file is too small for the size of the task (usually 
because of the /INC keyword). The system image supports’ the 
dynamic allocation of checkpoint space and therefore uses a 
checkpoint file to contain the rolled-out task. 

VMR -~ CIRCULAR REDIRECT ERROR 

The command tried to redirect a device such that a circular list 
of redirected devices would result. 


VMR ~- COMMAND I/O ERROR 


An I/O error was detected during a read from an indirect file. 


VMR -- COMMAND SYNTAX ERROR 
command line 


The command line printed has incorrect syntax. 


VMR ~~ COMMON BLOCK IS TASK PARTITION <common-name> 

A task's request for access to a common block is rejected because 
the partition requested is a task partition. 

VMR -- COMMON BLOCK NOT LOADED <common-name> 

The specified common block is linked to the task, but it has not 
been loaded into the system image. Install the specified common 
block, then install the task. 

VMR ~~ COMMON BLOCK OCCUPIED 

The command tried to load a common block that is already 
occupied. 

VMR -- COMMON BLOCK PARAMETER MISMATCH <common-name> 


Parameters of a common block do not match those in the task's 
label block. 
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VMR --— COMMON BLOCK SEGMENT COUNT ERROR 

The command tried to install a resident library with overlays, 
but the number of overlay segments specified in the task header 
is different from the number specified in the segment 
descriptors. 


VMR ~- DEVICE ddn: IS ATTACHED 


One or more device-units handled by the driver are attached. 
Therefore, the driver cannot be unloaded. 


VMR -- DEVICE ddn: NOT IN SYSTEM 


The specified device in the command was not defined in the system 
image; or the data base for a device driver to be loaded was 
neither in the system image nor in the driver's task image. 


VMR -- DEVICE NOT MOUNTED 


The device containing the system image file was not mounted. 


VMR -- DEVICE NOT REDIRECTABLE 


The specified device cannot be redirected. 


VMR -- DEVICE NOT TERMINAL 


The command tried to set terminal characteristics for a device 
that is not a terminal. 


VMR -~- DEVICE NOT VARIABLE SPEED MULTIPLEXER 


The command tried to set the baud rate for a terminal that was 
not attached to a DH11l or DZ11 multiplexer. 


VMR -- DRIVER ALREADY RESIDENT 

The specified device driver is already loaded or is permanently 
resident in the system image. 

VMR -- DRIVER BUILT WITH WRONG STB FILE 

The STB file for the driver is not compatible with the Executive 
STB file for the current system image. 

VMR -- DRIVER CANNOT BE UNLOADED 


The UNLOAD command attempted to remove a permanently resident 
device driver (that is, a driver linked to the Executive). 
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VMR -- DRIVER NOT LOADED 

The specified device driver in the UNLOAD command was not 
resident in memory. 

VMR -- DRIVER REQUIRES RUNNING SYSTEM FOR LOAD/UNLOAD 

The requested driver included the symbols S$ddLOA or SddUNL in its 
source. Support of driver load/unload calls can only be provided 
by MCR LOAD/UNLOAD. Note however, that these symbols are 
reserved for future use by the MCR LOAD and UNLOAD commands. 

VMR -- EXECUTIVE IS TOO LARGE 

The system image indicates that the Executive is larger than 16K 
words, but 20K Executive support was not included during SYSGEN 
or, if 20K Executive support was included, the Executive is 
larger than 20K. The system is unusable. 

VMR -- FILE filename HAS ILLEGAL FORMAT 

The specified symbol table file has an invalid format for an 
RSX-11M/RSX-11S symbol table file. 

VMR -- FILE filename HAS INCONSISTENT DATA 

The driver has an invalid loadable data base. When loading a 
common library, the partition extended beyond the size of the 
task image file and thus could not be loaded. See the RSX-11M 
Guide to Writing a Device Driver. 

VMR -- FILE name NOT A VALID DRIVER TASK IMAGE 

The driver's task image was either overlaid, had a task header, 
or referenced a resident library. 

VMR -- FILE NOT CONTIGUOUS 

The command tried to install a task or load a driver from a 
non-contiguous’) file. Task and loadable driver images must be 
contiguous files. 

VMR -- FILE NOT FOUND 

The requested file is not in the directory on the _ specified 
volume. 

VMR -~- FILE NOT TASK IMAGE 

Data in the label block is not correct, indicating that the file 
is not a valid task image. 


VMR -- ILLEGAL DEVICE/VOLUME 


The specified device is not a valid task residence device. 
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VMR -- ILLEGAL DRIVER TASK APR USAGE 

A device driver must be built for APR 5 and must be less than 4K 
(e.g. PAR=DRVPAR:120000:20000). This message applies to mapped 
systems only. 

VMR -- ILLEGAL ERROR-SEVERITY CODE code 

This message indicates an internal failure in VMR. If this error 
message persists, contact a Digital software representative. 

VMR -- ILLEGAL FILE SPECIFICATION 

filespec 

The indicated file specification has an illegal format or 
contains wild cards. 

VMR -- ILLEGAL FIRST APR 

A task was built using a base APR other than zero for 
non-privileged tasks or APR 4 or APR 5 for privileged tasks. If 
the Executive was built to support 20K of address space, APR 5 is 
the only valid base APR for tasks mapping into the Executive. A 
privileged task that does not map into the Executive must’ use 
APR 0 as its base. (See the RSX-11M Task Builder Reference 
Manual for a description of the /PR keyword.) This message 
applies only to mapped system images. 


VMR -- ILLEGAL FUNCTION 


A command was entered that VMR does not recognize. 


VMR ~- ILLEGAL GET COMMAND LINE ERROR CODE 


This error indicates a system failure. If this message persists, 
contact a Digital software representative. 


VMR -- ILLEGAL KEYWORD VALUE 


A value entered for a keyword exceeds its limits. 


VMR -- ILLEGAL OPERATION FOR SAVED SYSTEM 

The LUN and REASSIGN commands cannot be issued for a saved system 
image. 

VMR -- ILLEGAL PRIORITY 


The value of the priority in the command is out of range (that 
is, not 1 to 250(10), inclusive). 
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VMR -- ILLEGAL SWITCH 

/switch 

The indicated switch, in the context of the command line entered, 
is incorrect. 

VMR -- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 

The symbol symname has been defined to an illegal value by the 
file name. This occurs for several reasons, some general and 
some specific to the individual symbols. For example, most 
symbols cannot be defined to zero and mapped loadable drivers 
cannot reference SINTSV. 

VMR -~ INDIRECT COMMAND SYNTAX ERROR 

command line 

The indicated command line was entered with an improper indirect 
file specifier. 

VMR -- INDIRECT FILE DEPTH EXCEEDED 

command line 

The indicated command line was an attempt to exceed more than two 
levels of indirect files. 

VMR -- INDIRECT FILE OPEN FAILURE 

command line 

The indirect command file in the indicated command line could not 
be opened. 

VMR -- INTERRUPT VECTOR ALREADY IN USE 

A driver interrupt vector does not point to one of the nonsense 
interrupt entries in the system image. 

VMR -- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE name 

The driver had an invalid data base value at offset xxxx relative 


to the symbol S$ddDAT. (See the RSX-11M Guide to Writing an I/O 
Driver.) 


VMR -- INVALID INTERRUPT VECTOR 


The interrupt vector address specified in the driver data base 
was too high for the current system image. 


VMR -- INVALID KEYWORD 


A keyword has been encountered that is incorrect in the context 
of the specified command. 
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VMR -- INVALID RECORD ADDRESS FOR FILE name 

An attempt was made to write outside of the system image file or 
to write beginning at a byte boundary. The most frequent cause 
of this, is a corrupted system image or an STB file that does not 
Match the system image. 

VMR -~- INVALID SPEED 

The specified multiplexer line does not support the requested 
speed; or the command specified unequal receive and transmit 
speeds for a DZ11. The DZ11 does not support split speeds. 

VMR -- INVALID TIME PARAMETER 


A time field is incorrect. 


VMR -- INVALID UIC 


A value of zero for either the group number or the member number 
was detected. 


VMR -- I/O ERROR ON INPUT FILE filename 


An input I/O error occurred on the indicated file. 


VMR -~ I/O ERROR ON OUTPUT DEVICE 


An output I/O error was encountered while saving the system. 


VMR -- I/O ERROR ON OUTPUT FILE filename 


An output I/O error occurred on the indicated file. 


VMR -~ LENGTH MISMATCH COMMON BLOCK <common~name> 


The length parameter for the common block, as described in the 
label block for the task image, is different from the 
corresponding length parameter defined in the system image. A 
task's label block data must match system data for that task 
before it can be installed. 


VMR -- LINE NOT DZ11 


The command attempted to declare a line remote that was not 
attached to a DZ11 multiplexer. 


VMR -- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


The system generation option to support loadable device drivers 
was not chosen for the system image. 
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VMR -- LOGICAL DEVICE NOT IN SYSTEM 

The specified logical device is not defined in the logical device 
tables. 

VMR -- LUN OUT OF RANGE 

The command tried to re-assign a LUN which is greater than _ the 
maximum number of LUNs allocated during task build. 

VMR -- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 

This is a warning message. The command attempted to install the 
task as checkpointable; but the task was not built with 
checkpoint space allocated in its task image file. Because’ the 
system does not support the dynamic allocation of checkpoint 
space, it considers the task not to be checkpointable. 

VMR -- NO LUNS 

The task specified as the argument of the LUN command does not 
have any logical units assigned. This is not an error message; 
rather, it is an indication that there are no assignments’ to 
display. 

VMR -- NO POOL SPACE 

A request for dynamic memory in the system image by VMR cannot be 
satisfied. 


VMR -- NO ROOM AVAILABLE IN STD FOR NEW TASK 


There is no dynamic storage available to make an entry in the 


system task directory (STD); therefore, the task cannot be 
installed. 
VMR -- NON EXISTENT MEMORY 


The command tried to define a partition in nonexistent memory. 


VMR -- NOT ENOUGH APRS FOR TASK IMAGE 


The Task Builder allows you to specify the virtual base address 
of a task image as a multiple of 4K. Privileged tasks start ata 
virtual 100000(8) to map the first 16K of the Executive, or 
virtual 120000(8) to map the first 20K of the Executive, at the 
same time as the user task. If the virtual base address is set 
too high, the task image may not be able to be mapped with the 
remaining mapping registers. This message is applicable to 
Mapped system images only. 


VMR -- OLD DEVICE ATTACHED 


The command tried to redirect an attached device-unit. 
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VMR -- OPEN FAILURE ON FILE filename 


The indicated file could not be opened. 


VMR -- PARTITION ALREADY EXISTS 


The command tried to define a partition with a name that is 
already in use. 


VMR -- PARTITION BUSY 


The partition in which the task was to be fixed or driver loaded 
was occupied. An attempt was made to fix a task in a 
system-controlled partition. An attempt was made to unload a 
partition with installed tasks or loaded drivers. 


VMR -- PARTITION parname IS A COMMON 

The command tried to load a device driver into a common 
partition. A device driver cannot be loaded into a common 
partition. 


VMR -- PARTITION NOT COMMON 

A partition specified for a common area or library is not defined 
as a common partition. 

VMR -- PARTITION NOT IN SYSTEM 


The partition name specified as an argument in a command cannot 
be found in the system image. 


VMR -- PARTITON par NOT IN SYSTEM, DEFAULTING TO GEN 

This is a warning message. The specified partition does not 
exist; VMR therefore attempts to install the task in the GEN 
partition. 

VMR -- POOL LINK ERROR AT xxxx BLOCK=yyyy 222z 

When SET /POOL traced the pool linkage, an error was detected at 


location xxxx in the system image. The contents of xxxx is yyyy 
and the contents of xxxx+2 is z222z. 


VMR -- PRIVILEGED TASK LARGER THAN 12K 


A privileged task was larger than 12K. Privileged tasks on an 
unmapped system have a maximum size of 12K. 


VMR -- PSEUDO DEVICE ASSIGNMENT ERROR 


A logical device name may not be assigned to a pseudo device. 
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VMR -- PSEUDO DEVICE REDIRECT ERROR 


The command tried to redirect a pseudo device to another pseudo 
device. 


VMR -- RECEIVE DATA OR BY REFERENCE LIST NOT EMPTY 


A task with entries in its receive queues cannot be removed from 
the system image. 


VMR -- SPACE USED 


The command tried to create a partition or a subpartition in a 
Main storage area already occupied. 


VMR -- SPECIFIED PARTITION FOR COMMON BLOCK 


The command tried to install a task in a common block. 


VMR -- SPECIFIED PARTITION TOO SMALL 

The task being installed is larger than the partition into which 
it is being installed. 

VMR -- SYMBOL symname IS DOUBLY DEFINED BY FILE name 

The symbol symname is defined twice by the file name. Duplicate 
symbols are illegal. 

VMR -- SYMBOL symname IS UNDEFINED IN FILE name 


The symbol symname was found in the file name, but it was not a 
symbol definition. 


VMR -~ SYNTAX ERROR 

This message generally indicates that the reguired information 
has been entered incorrectly. You can usually correct this 
condition by retyping the arguments according to the command 
specifications. 


VMR -- TASK ACTIVE 


The task used as the argument of the command is active. 


VMR ~~ TASK ALREADY FIXED 


The task used as the argument of the FIX command is already fixed 
in the system image. 


VMR -- TASK AND PARTITION BASES MISMATCH 


The base of the partition does not match that of the task being 
installed. Applicable only to unmapped system images. 
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VMR -~- TASK IMAGE I/O ERROR 
VMR could not read the task~image file, or the INSTALL command 


could not rewrite the task-image header. (The device is 
write-locked.) 


VMR -- TASK IMAGE CURRENTLY INSTALLED 

The requested task image, which was checkpointable, had already 
been installed. On systems that do not support the dynamic 
allocation of checkpoint space, checkpointable tasks that have 


checkpoint space allocated can be installed only once; other 
tasks can be installed more than once. 


VMR -- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK <block-name> 


The virtual addresses reserved for the task image overlap those 
reserved for the common block specified. A corruption of the 
task image file probably caused the overlap. 


VMR -- TASK IS CHECKPOINTABLE 


A checkpointable task cannot be fixed in the system image. 


VMR -- TASK NAME ALREADY IN USE 


The command tried to install a task having the same name as_ one 
already in the system image. 


VMR -- TASK NOT FIXED 


The command tried to unfix a task that is not fixed. 


VMR -- TASK NOT IN SYSTEM 


The referenced task has not been installed. 


VMR -- TI REDIRECT ERROR 


The pseudo device TI: may not be redirected. 


VMR - 


TOO MANY COMMON BLOCK REQUESTS 


A task is Limited to seven common blocks. 


VMR -- TOO MANY LUNS 


A task has requested more than 255(10) LUNs to be assigned. 
VMR -- TOO MANY SUBPARTITIONS 


The command tried to define more than seven subpartitions. A 
Main partition is limited to a maximum of seven partitions. 
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VMR -- UNDEFINED COMMON BLOCK <common~-name> 


A task references a common block that is not defined in the 
system image. Usually, this indicates that the task was built to 
run in another system. 


VMR -- UNKNOWN MAIN PARTITION 


The command tried to define a subpartition of a nonexistent main 
partition. 


VMR -- WARNING - PRIVILEGED TASK OVERMAPS I/O PAGE 


This message warns that a privileged task that may require access 
to the I/O page does not have the access. A privileged task that 
is mapped into the Executive is usually also mapped into the I/0 
page in order to access the KT1l registers and other devices. 
Many privileged tasks do not require this access and can use the 
additional 4K words of virtual address space for the task image. 


VMR ~~ WRITE CHECK NOT SUPPORTED FOR DEVICE 


The command tried to enable write check on a device that does not 
support it. Write check is currently supported for all disks 
except DL: and DxX:. 


CHAPTER 6 


MOVING A VERSION 3.1 SYSTEM TO A VERSION 3 DISK 


When an existing RSX-11M V03 system with a hardware configuration of 
one RP02/03/04 drive plus magtape, is to be converted to a V03.1 
system, there are basically two procedures available. They are 
described below. (A is the pack with the existing V03 system, B is an 
initially blank pack.) 


Procedure 1 -- Put A in the drive and boot the V03 system. 
Transfer all user files from A to magtape. Put B in the drive 
and do a V03.1 SYSGEN. Transfer all user files from magtape to 
B. 


Procedure 2 ~~ Put B in the drive and do a V03.1 SYSGEN. 
Transfer all files required to install and run a V03.1 system to 
Magtape. Put A in the drive and boot the V03_ system. Transfer 
V03.1 system files from magtape to A. Install and boot the V03.1 
system on A. 


In both procedures, magtape transfers are done by FLX. 


The decision of which procedure to use depends primarily on the total 
volume of user files. If the volume is large, procedure 1 could 
require a large number of magtapes and many hours of work for’ the 
operator. 


Another problem is that FLX truncates file names that are longer’ than 
6 characters, and does not preserve the version number field of the 
file name. 


Therefore, procedure 2 is more attractive when there is a large number 
of user files. There are two command files on the RP02/03/04 
distribution kit that do most of the work. They are stored under UFD 
[200,200] with the names COPSY1.CMD and COPSY2.CMD. 


COPSY1 and COPSY2 both assume that the V03.1 target system is the same 
type as the V03 system that exists already, where "type" refers to 
Mapped or unmapped. The RP02/03 and RPO04/05/06 distribution kits 
contain both mapped and unmapped systems. Therefore, when starting 
COPSY1, make sure you are running a system of the same type as your 
vV03 system. 


In the descriptions of COPSY1 and COPSY2, there are command lines’ and 
comments containing a UIC or UFD of the following type: 


[1,2x] 


where the character x will be replaced by 0 if the current system is 
unmapped, and by 4 if the current system is mapped. 


MOVING A VERSION 3.1 SYSTEM TO A VERSION 3 DISK 


The following are instructions on the procedure, and details of the 
COPSY1 and COPSY2 command files. 


First, transfer the V03.1 distribution kit from magtape to a blank 
pack and perform a SYSGEN, as described in Chapter 3. Near the end of 
SYSGEN part 2, when VMR is invoked, the example tells you to invoke 
the command file INSTALL.CMD to install tasks in the target system. 
If you intend to use COPSY1 and COPSY2, do not invoke INSTALL.CMD. 
Also, do not boot the target system. Instead, when SYSGEN part 2 has 
finished, issue the following command: 


>@[200,200] COPSY1 


6.1 COPYING VERSION 3.1 TO MAGTAPE 


COPSY1 <VERSION 02> 


COPYRIGHT (C) 1976,1977 
DIGITAL EQUIPMENT CORP., MAYNARD MASS. 01754 


THIS COMMAND FILE TRANSFERS ALL FILES NECESSARY TO RUN AN 
RSX-11M V0O3.1 SYSTEM FROM THE CURRENT V03.1 SYSTEM DISK TO A 
MAGTAPE. ADDITIONALLY, THE COMMAND FILE COPSY2.CMD IS 
TRANSFERRED. COPSY2 WILL COPY THE FILES FROM THE MAGTAPE 

TO THE V0O3 SYSTEM DISK AND INSTALL A V03.1 SYSTEM ON THAT DISK. 
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’ 
INS [1,5x] FLX 
* WHAT DEVICE IS THE MAGTAPE MOUNTED ON [DDU] [S]: 


The following commands assume your magtape drive is a TS03 
or TU10, in which case you answer MT to the question above. 
Otherwise, all occurrences of MT in the following commands 
are replaced by MM. 

LOA MT: 


MOUNT A BLANK MAGTAPE IN MTO: 


% 0 we we 


IS MTO: READY? [Y/N]: 


When the tape is ready, files from UFD [1,1] and [1,2] are 
copied to tape as well as the command file INSTALL.CMD, 
which was created by SYSGEN Part 2 and the Executive 
assembly prefix file RSXMC.MAC. 


SET /UIC=[200,200] 

FLX MT:/ZE 

FLX MT: /DO=COPSY2.CMD/RS, INSTALL.CMD,RSXMC.MAC 

SET /UIC=[1,1] 

FLX MT: /DO=SYSLIB.OLB/RS,EXELIB.OLB, RSXMAC.SML,EXEMC.MLB 
FLX MT: /DO=ODT.OBJ/RS, TRACE. OBJ 

SET /UIC=[1,2] 

FLX MT: /DO=QIOSYM.MSG/RS,SYE.HLP,STARTUP.CMD 


SET /UIC=[1,2X] 


FLX MT: /DO=RSXBLD.CMD/RS,RSX11M.OLB 
SET /UIC=[1,5x] 

FLX MT: /DO=*.TSK/RS,*.SYS,*.STB 

REM FLX 

UNL MT: 
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DEA MT: 


NOW DISMOUNT AND REMOVE THE CURRENT SYSTEM DISK FROM THE TAPE DRIVE. 
MAKE A BACKUP OF THE V03 SYSTEM DISK, IF YOU DON'T HAVE ONE 

ALREADY. THEN PUT THE V03 SYSTEM DISK IN A DRIVE AND BOOT 

IN THE SYSTEM. USE FLX TO TRANSFER COPSY2.CMD FROM THE TAPE 

TO THE SYSTEM DISK AND THEN INVOKE IT AS AN INDIRECT COMMAND FILE. 


EXAMPLE: 
>DMO SY: 
(BOOT THE V03 SYSTEM) 
>SET /UIC=[200,200] 
>RUN SFLX 
FLX>=MT0:COPSY2.CMD 
FLX>“2Z 
>@COPSY2 


COPSY2 CONTAINS FURTHER INSTRUCTIONS. 
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End of COPSY1. 


6.2 COPYING VERSION 3.1 TO A VERSION 3 DISK 


COPSY2 <VERSION 02> 


COPYRIGHT (C) 1976,1977 
DIGITAL EQUIPMENT CORP., MAYNARD MASS. 01754 


YOU SHOULD MAKE A BACKUP COPY OF THE V03 RSX11M SYSTEM DISK 
BEFORE YOU PROCEED ANY FURTHER. 


%~e we we we ME Te NO NO 


DO YOU WANT TO PROCEED? [Y/N]: 


If the question above is answered with an N, the command 
file processing terminates. When ready, restart COPSY2. 
Otherwise, processing continues here. 


THIS COMMAND FILE WILL USE TWO UFD'S FOR SPECIAL PURPOSES: 
- [2,5x] FOR STORAGE OF THE EXISTING V03 SYSTEM 
~ [377,377] AS A SCRATCH UFD 
IF EITHER UFD IS ALREADY IN USE, YOU MUST EDIT 
THIS COMMAND FILE AND CHANGE ALL OCCURENCES OF THE RESPECTIVE 
UFD TO WHATEVER YOU PREFER. 
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DO YOU WANT TO CHANGE UFD‘S? [Y/N]: 


If the answer is Y, the following example is displayed, and 
the processing terminates. When ready, restart COPSY2. 


THE FOLLOWING SHOWS HOW TO CHANGE THE SCRATCH UFD ([377,377]) 
TO [377,300], AND THE STORAGE UFD TO [3,44]. 


>SET /UIC=[200,200] 
>RUN SEDI 
EDI>COPSY2.CMD 


=e "6 “@ se “SO “08 “OE 


MOVING A VERSION 3.1 SYSTEM TO A VERSION 3 DISK 


*BL OFF 

*TOP 
*PAS/377,377/377,300/ 
*TOP 

*L [2,5X] 
*C/2,5$S/3,44/ 

ED 
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WHEN THE EDIT IS COMPLETE, RESTART COPSY2. 
If no edits have to be done, processing continues here. 
THIS COMMAND FILE TRANFERS THE FILES FROM THE MAGTAPE CREATED 


BY COPSY1 TO AN RSX-11M V03 SYSTEM DISK. 
THE FILES ARE MADE CONTIGUOUS WHERE REQUIRED. 


=e ses ~e Ne 


* 


IS YOUR MAGTAPE DRIVE A TU16 OR TU45? [Y/N]: 

INS [1,5x] FLX 

INS [1,5x]PIP 

INS [1,5x]UFD 
If any of the INS commands above failed, for example because 
your system has partitions with nonstandard names, you will 
be asked to install the task(s) manually. 

* DID ANY OF THE PREVIOUS INSTALLS FAIL? [Y/N]: 
If the answer to this question is Y, the following is 
displayed. 

WE WILL PAUSE TO ALLOW YOU TO INSTALL ANY TASKS WHICH 

FOR SOME REASON MAY NOT HAVE BEEN INSTALLED SUCCESSFULLY. 
T. -- PAUSING. TO RESUME TYPE "RES ...AT." 


WE NOW CREATE THE TEMPORARY VERSION 3 SYSTEM UFD 
AND THE SCRATCH UFD. 


ee te MO YD we me te Ne 


c 

UFD SY: [2,5x] 

UFD SY: [377,377] 

REM UFD 

RENAME ALL FILES UNDER THE CURRENT SYSTEM UFD TO THE 
TEMPORARY VERSION 3 SYSTEM UFD. 
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SET /UIC=[1,1] 
PIP [2,5x]/RE=[1,5x]*.*;* 


; WE NOW TRANSFER FILES FROM MAGTAPE. 


‘ 

SET /UIC=[200, 200] 

FLX =MT: INSTAL.CMD,RSXMC.MAC 

PIP INSTALL.CMD/NV/RE=INSTAL.CMD 
SET /UIC=[1,1] 

FLX =MT:SYSLIB.OLB,EXELIB.OLB 
PIP SYSLIB.V03.1/CO=SYSLIB.OLB 
PIP SYSLIB.OLB;0/DE 

PIP EXELIBV03.1/CO=EXELIB.OLB 
PIP EXELIB.OLB;0/DE 

FLX =MT:RSXMAC.SML,EXEMC.MLB,ODT.OBJ, TRACE.OBJ 
SET /UIC=[1,2] 
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FLX =MT:QIOSYM.MSG,SYE.HLP,STARTUP.CMD 
SET /UIC=[1,2xX] 
FLX=MT: RSXBLD.CMD,RSX11M.OLB 


SET /UIC=[377,377] 

FLX =MT:[1,5x]*.* 

REM FLX 

SET /UIC=[1,5X] 

PIP /CO=[377,377]*.TSK,*.SYS 

PIP. [377,377] ". TSK3*/DE,*.SYss* 
PIP=[377,377] 

PIP [377,377]*.*;*/DE 

SET /UIC=[1,1] 

PIP SYSLIB.OLB/RE/NV=SYSLIV03.1 
PIP EXELIB.OLB/RE/NV=SYSLIBV03.1 
PIP EXELIB.OBL/RE/NV=EXELIBV03.1 
REM PIP 

SET /UIC=[1,5X] 


;WE NOW INVOKE VMR TO INSTALL THE TASKS IN THE 
V03.1 SYSTEM USING THE COMMAND FILE [200,200] INSTALL.CMD. 


NOTE - IT IS ASSUMED THAT YOU HAVE NOT INSTALLED ANY 

TASKS WITH VMR DURING SYSGEN PART 2! IF YOU HAVE, YOU 
SHOULD OBTAIN A TASK LISK ( VMR>TAS ) AND REMOVE THE 

TASKS WITH VMX BEFORE CALLING INSTALL.CMD. 


EXAMPLE: 


>VMR 

ENTER FILE NAME: RSX11M 

VMR>TAS 

- LDR. LDR 248. 000000 SY0:00000000 FIXED 
TKTN 03 SYSPAR 248. 010000 SY0:00103137 
---MCR 02 SYSPAR 160. 010000 SY0:00101476 


VMR>REM TKTN 
VMR>REM ...MCR 


VMR>@[200,200] INSTALL 
VMR>~Z 
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‘ 

REM VMR 
INS VMR 
ASN SY:=LB: 
VMR 

REM VMR 


When the VMR session is finished, processing continues here. 
THE VERSION 3.1 SYSTEM IS NOW READY TO BOOT WITH THE 
FOLLOWING COMMAND. 
>BOO RSX11M 


WHEN THE NEW SYSTEM IS UP AND RUNNING, DELETE THIS COMMAND 
FILE, WHICH IS NO LONGER NEEDED, WITH THE FOLLOWING COMMANDS: 


>SET /UIC=[200,200] 
>PIP COPSY2.CMD;*/DE 
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ALSO, DELETE THE SCRATCH UFD WITH THE FOLLOWING COMMAND 
(ASSUMING THE UFD IS "[377,377]"): 


>PIP [0,0]377377.DIR;*/DE 


YOU MAY THEN DELETE ALL VERSION 3 SYSTEM FILES FROM THE 
DISK. EXAMPLE: 


>SET /UIC=[1,1] 

>PIP *.*/PU,[1,2]*.* 

>PIP [1,2x]RSXBLD.CMD/PU,RSX11M.OLB 
>PIP [200,200] RSXMC.MAC/PU 

>PIP [2,5x]*.*;*/DE 

>PIP [{0,0]00205x.DIR;*/DE 


THE DISK PACK NOW CONTAINS ALL FILES NEEDED TO RUN THE 

VERSION 3.1 SYSTEM. IF YOU WANT OTHER FILES FROM THE VERSION 3.1 
DISTRIBUTION KIT TRANSFERRED TO THIS DISK, (E.G. CMD, ODL 

AND OLB FILES TO REBUILD ANY UTILITIES), YOU MUST COPY 

THEM MANUALLY VIA MAGTAPE WITH FLX. 


End of COPSY2. 


APPENDIX A 


SYSTEM CONVENTIONS 


A.1 RSX-11M UIC CONVENTIONS 


The RSX-11M Release 3.1 distribution kits observe a set of UIC 
conventions for files on disk. The purpose of these conventions is to 
provide a uniform and consistent means of allocating, locating, and 
maintaining files on disk. 


On a disk, there are many User File Directories (UFDs) in which files 
are catalogued. A particular UFD is referenced by specifying the 
correct UIC. The UIC consists of two numbers separated by a comma and 
enclosed in brackets (such as UIC [11,20]). The first number (11) is 
the group number; the second number (20) is the member number, which 
indicates a specific directory within a group of directories. RSX-11M 
makes use of the UICS to keep related files in specific directories. 


A.1.1 Group Number 


The group number is used to identify groups of directories. By 
convention, group numbers of 1 through 10 are reserved for access by 


the Executive. At present, only group number 1 is used. It is’ used 
to identify UFDS which contain files relevant to an RSX-11M system. 
Group numbers 11-377(8) may be used for user files. Please note, 


however, that group numbers 11-27(8) are reserved by Digital for 
storing files relevant to the Executive and Ancillary Control 
Processors ({ACP). 


Group Number ll is used for Executive files 
12 is used for MCR files 
13 is used for FCP files 


In addition, group numbers 30-177(8) are reserved for 
DEC-Supplied software tasks. The distribution kit only uses group 
numbers 1, 11, 12, 13, 15, 35, 45, and 200. 


Group number 15 is used for privileged utility tasks 
(PMD, RMDEMO, etc.) 

Group number 35 is used for DMP files 

Group number 45 is used for K-series files 

Group number 200 is used for SYSGEN indirect command files 


A.1.2 Member Number 


The second number (member number) is used to hold different file types 
of the group. For example, the UIC [11,10] contains source modules of 
the Executive. Member numbers currently in use are: 
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10 - Source modules. 


20 - Object modules, assembly and task build command 
files, object module libraries, overlay descriptor 
files for the Executive and all unmapped 
privileged and nonprivileged tasks. 


24 - Same as 20 above, except that files are for mapped 
privileged and nonprivileged tasks, and _ the 
Executive. 


30 - Listing and map files for all unmapped privileged 
and nonprivileged tasks. 


34 - Listing and map files for all mapped privileged 
and nonprivileged tasks. 


40 - SLP correction files for files located under 
member number 10. 


50 7 Tasks and Executive for RSX-11M unmapped system. 
54 - Tasks and Executive for RSX-11M mapped system. 
60 = Tasks and Executive for RSX-11S unmapped system. 
64 - Tasks and Executive for RSX-11S mapped system. 
200 - SYSGEN indirect command files. 


Member numbers 50, 54, 60, and 64 exist only for group number 1. 
Member numbers 10 and 40 exist only for group numbers above 10. 
Member numbers 20, 24, 30, and 34 exist for all group numbers. Member 
number 200 is used exclusively with group number 200. 


For example, for MCR: 
[12,10] Source files. 


[12,20] Unmapped object modules, assembly command files 
and library build command file. 


[12,24] Mapped object modules, assembly command files and 
library build command file. 

[12,30] Unmapped listing files. 

[12,34] Mapped listing files. 


[12,40] SLP correction files for files under [12,10]. 


For the unmapped system: 


[1,20] Object module libraries, task build command files, 
and Task Builder overlay description files for all 
tasks. 

[1,30] Area for task maps. 

[1,50] RSX-11M Executive and system tasks. 


For the mapped system: 


[1,20] Object module libraries, all task build overlay 
descriptor files for all nonprivileged tasks. 
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[1,24] Object module libraries, task build command files 
for all mapped tasks, and overlay description 
files for all privileged tasks. 

[1,34] Executive and task maps. 


{1,54] RSX-11M Executive and system tasks. 


Other UICs: 
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[1,1] System and macro object module libraries. 
[1,2] System message files. 

[1,3] Directory for lost files found by VFY. 

[1,4] Directory for Post-Mortem and Snapshot Dumps. 
{1,6] Directory for error log files. 


NAMING CONVENTIONS 


System file names have the following general format: 


pppnnnsss.typ 


where: 


Ppp 


nnn 


sss 


typ 


is an optional prefix used to designate a special version or 
characteristic of the named file. The designation BIG, for 
example, iS sometimes used to designate a task, such as TKB, that 
is built to operate in more than 8K of memory, e.g., BIGTKB. 


is the system identification for the task. Table A-l lists all 
system tasks, together with the identification and group codes. 


is a suffix for noting the relationship of the file to the task 
specified in the nnn identification. For example, PIPBLD.CMD is 
the command file for building PIP. 


Suffixes: 


ASM - Assembly command file 
BLD - Task Builder command or overlay description file 


is the standard mnemonic for file type, Such as MAP, CMD, etc. 


Types: 

CMD - Command File 

LST - MACRO-11 Listing File 

MAC - MACRO-11 Source File 

MAP - Task Map File 

MLB -—- User Macro Library File 

OBJ - MACRO-11 Object Library File 
ODL - Overlay Description File 

OLB - Object Library File 

PMD - Post-Mortem or Snapshot Dump File 
SML - System Macro Library File 
STB - Task Symbol Table File 

TSK - Task/Driver Image File 
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Table A-1l 
System Identification Codes 


SYSTEM 
ID DESCRIPTION 

RSX RSX-11M/S Executive, drivers, and tables 

MCR Monitor Console Routines 

FCP Files-1ll Ancillary Control Processor (ACP) 

PMD Post-Mortem and Snap-Dump Processor 

BMR Basic MCR (RSX-11S) 

ERL Error Logger 

OTL On-Line Task Loader (RSX-11S) 

SIP System Image Preservation Program (RSX-11S) 

MTA Magtape ACP 

MAC MACRO-11 Assembler 

TKB Task Builder 

PIP Peripheral Interchange Program 

FLX File Transfer Program 

VFY File Structure Verification Program 

DMP File Dump Utility 

DSC Disk Save and Compress Utility (task version) 

EDI Line Text Editor 

SLP Source Language Input Program 

PRESRV Volume Preservation Program 

LBR Librarian 

PRT Print Spooler 

ODT, TRACE Online debugging tool, trace 

FCS File Control Services 

FOROTS FORTRAN-IV Object Time System 


PSE,SYE Error log formatters 


ZAP File Patch Utility Program 


(Continued on next page) 


SYSTEM CONVENTIONS 


Table A-1l (Cont.) 
System Identification Codes 


SYSTEM GROUP 
ID CODE DESCRIPTION 
BAD Bad Block Locator Program 


DSCSYS Disk Save and Compress Utility (stand-alone 
version) 


CRF Cross Reference Utility Program 


VMR Virtual MCR Program 
UMD User Mode Diagnostics 
FTB Fast Task Builder 

CMP File Compare Utiltiy 


PAT Object Module Patch Utility 


APPENDIX B 


OPERATING HINTS 


B.1 BOOTSTRAPPING A WRITE-LOCKED DISK 


It is possible to bootstrap RSX-11M from a write-locked disk. In the 
Baseline System, this usually manifests itself in the lack of response 
from the MOUNT command in the load sequence of the system and in the 
display of checkpoint write errors for the SAVE command. Thus, for a 
system bootstrapped from DKO:, the console output might be displayed 
as: 
RSX-11M V03.1 BL22 24k 

>RED LB:=DK0: 

>RED SY:=DK0: 

>MOU DKO:UNMOBJ 

**e* |..SAV SY0: -- CHECKPOINT WRITE ERROR 

***k ...MCR SY0: -- CHECKPOINT WRITE ERROR 


The problem occurs because SAVE and MOUNT run in the same partition. 
SAVE is checkpointable and waits for MOUNT to complete before 
continuing. Because SAVE could not be checkpointed due to the disk 
being write-locked, MOUNT could not get in. There are two solutions 
to the problem: 


1. Write-enable the disk and reboot. 
2. Write-enable the disk and abort SAVE. This will allow MOUNT 
to come in and run. When MOUNT has completed, the system 


will prompt normally. The user will then have to issue _ the 
@{1,2] STARTUP command manually. 


B.2 RUNNING OUT OF DYNAMIC MEMORY 


It is possible to exhaust dynamic memory during the running of 


RSX-11M. This can occur if a large number of tasks are installed, 
if many volumes are mounted, or if a number of other conditions are 
present. (The following section describes all dynamic memory uses.) 


This problem can manifest itself in the lack of any response from the 
system. Although the system looks like it is operating successfully, 
it cannot accept any MCR commands or complete the execution of 
presently running tasks because they all require dynamic memory. 
Another manifestation of the problem may be I/O errors being received 
by tasks or failures in the Loader due to pool allocation failures. 
The only solution to this problem is to bootstrap the system and make 
more dynamic space available (SET /POOL), remove tasks, mount fewer 
volumes, rebuild FCP with space for more file control blocks in its 
partition, or rebuild the system with more dynamic memory. 
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B.3 DYNAMIC MEMORY REQUIREMENTS 


During the course of its execution, the RSX-11M Executive has varying 
needs for dynamic memory. At any one time, many I/O requests can be 
active, several files can be open, or multiple time-dependent 
scheduling requests can be queued. Rather than allocate a fixed 
amount of memory for each requirement, the RSX-11M Executive makes use 
of a dynamically allocated memory space called the dynamic storage 
region. As demands for space are made, the necessary memory is 
allocated from this region using a first-fit algorithm. When 
allocated space is no longer needed, it is released back to the pool 
of available memory. The initial size of the dynamic storage region 
is established during the execution of the System Generation 
query files. This initial allocation can be extended later via 
the MCR SET /POOL command when the generated system is bootstrapped. 


Dynamic memory requirements for a system are dependent on the 
configuration, application, and degree of system loading. Enough 
memory must be available to satisfy peak demands; otherwise, a 
degradation in system performance will occur. On the other hand, if 
too much memory is made available, it is never used and is’ thus 
wasteful of system resources. 


Summarized below are the sources that make demands on the dynamic 
storage region. In general, a system should contain a dynamic storage 
region equal to the size of the aggregate sum of the peak demands made 
simultaneously among the various categories. Having calculated this 
figure, it is also advisable to add an increase of approximately ten 
percent to cover possible fragmentation contingencies. The maximum 
size of the dynamic storage region is limited by physical memory in an 
unmapped system. In a mapped system, the total size of the Executive, 
resident drivers, and the dynamic storage region, must be less’ than 
16K or 20K words (depending on the way the system was generated). 


B.3.1 Sources Requiring Dynamic Memory 


The following list identifies those system elements requiring dynamic 
memory: 


1. Each task installed in the system requires at least 20 words 
for a task control block. 


2. Each I/O request results in the allocation of an 18-word I/O 
packet, which is queued to the appropriate device driver. 


3. Each Send Data or Send by Reference message sent to aé_ task 
results in an 18-word message packet being allocated to hold 
the requisite data. 


4. Each main partition and subpartition requires a partition 
control block of at least 14 words to describe its memory. 
In addition, for each active task, fixed task, and loaded 
driver in a system-controlled partition (whether the tasks 
are checkpointed or in memory) a PCB is built and allocated 
in the dynamic storage region. 


5. Each open file requires 18 words for a file control block and 
18 words for a window block which contains virtual-to-logical 
block mapping pointers. (See space saving hint 3 below.) 


10. 


ll. 


12. 


A ee 


14. 


15. 


16. 
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Each mounted volume requires 18 words for a volume control 
block, 18 words for the index file window block, and 18 words 
for the index file control block. In addition, three 18-word 
control blocks are required to hold information pertaining to 
the last three directory files that were accessed. For 
systems that include I/O optimization, MOU will try to 
allocate a window block for the index file of sufficient size 
to contain all the retrieval pointers. This could require up 
to 208 words. If the space is not available, MOU will 
default to 18 words. (See space saving hint 4 below.) 


Each clock queue entry requires eight words. These entries 
represent mark time, schedule, and periodic rescheduling 
requests. 


Each powerfail, receive, and FPP AST trap-enable for active 
tasks requires eight words for an AST control block. 


All terminal input is buffered in the terminal driver before 
transferring information to the user buffer. Each solicited 
and unsolicited input request requires a 42-word input 
buffer. 


Card images read from the CM/CR11 are buffered by the card 
reader driver before transferring the translated information 
to the user buffer. Binary input requires an 80-word buffer, 
whereas ASCII input requires a 40-word buffer. 


Each LPS11/AR11 synchronous function requires 20 words for a 
sample control block. 


In a mapped system, the task header is copied into a block of 
memory allocated from the dynamic storage region. 
Approximately 64 words (dependent upon the number of LUNs and 
window blocks) are required for each task that is in memory 
(i.e., in execution and not checkpointed, or inactive and 
fixed). 


Each task linked to ICS/ICR-11 interrupts requires 16 words 
of dynamic memory, plus six words for each interrupt linkage. 


Data bases that are loaded into a system with a loadable 
driver require space equal to the size of the data base. 


Loaded drivers on a mapped system require space for interrupt 
linkage as follows: 


- 14 words per interrupt entry for single-controller, 
non-error-logging drivers, 


- 22 words per interrupt entry for multi-controller, 
non-error-logging drivers, 


~ 14 words for the first (or only) interrupt entry for 
error-logging drivers, and 


- 6 words for each additional interrupt entry for 
error-logging drivers. ; 


Systems with dynamic checkpoint space allocation require 8 
words to describe each checkpoint file and 8 words for each 
task checkpointed to a checkpoint file. 
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17. Systems supporting the memory management directives require 6 
words per task (active or fixed) for each region a task is 
attached to. This includes the task region and all static 
and dynamic commons. 


18. Variable-length packets are allocated for each logged error 
which has not yet been serviced by the error logger. (See 
the RSX-11M Error Logging Reference Manual.) 


B.3.2 Space Saving Hints 
The following list identifies potential methods of saving space: 


1. By including the install, request, and remove on exit 
capability into a generated system, considerable dynamic 
memory may be saved for tasks that are initiated from a 
terminal. The MCR RUN command will install the tasks when 
needed and cause them to be removed when they exit (see the 
RSX-11M Operator's Procedures Manual). Thus, task control 
blocks need not be permanently allocated. Typical tasks in 
this category are the program development and utility tasks 
provided with the RSX-11M system, (PIP, MAC, TKB, etc.). 


2. The use of checkpointing and nonresident’ tasks, where 
appropriate, can reduce the number of tasks that are 
Simultaneously in memory. This saves space in a mapped 
system, since fewer task headers need to be copied. 


3. The file system ACP (FI1ACP) may be built to store File 
Control blocks in its own task image rather than in the 
dynamic storage region. The more space allocated at task 
build time the less the demand will be on the pool. However, 
if the allocatéd space becomes used up, the overflow will use 
the dynamic storage region. 


4. The directory least-recently-used table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. 
If this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number 
of FCBs used. 


B.4 PARITY MEMORY SUPPORT 


As an option, RSX-11M will support parity memory on all processors. 
In addition, parity on the PDP-11/70 cache is supported. If a main 
memory parity error is detected with this option selected, the task 
occupying the space where the error was detected will be aborted and 
locked in memory to prevent re-using it. A message will be issued 
noting the fact that the task was aborted due to a parity error. If 
the error is detected in the Executive, the system will attempt to 
print the following message before halting: 


**k* EXEC PARITY ERROR STOP*** 
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For 11/70 cache parity errors, the half of the cache in which the 
parity error was detected will be disabled if two errors in the same 
half are detected within the same minute. If less than one error per 
minute is detected, and the system recovers by reading through to main 
memory, the cache will not be disabled. With either one or _ both 
halves of the cache disabled, the processor will still operate, but in 
a degraded state. If error logging is supported, cache parity errors 
will be logged. 


B.5 SAVING THE SYSTEM WITH A KW11-Y WATCHDOG TIMER 


Before a system with a KW11-Y watchdog timer is saved, the timer must 
be disabled. There is a switch located on the timer for this purpose. 
The timer must be disabled because SAVE assumes exclusive control over 
the system for the duration of the save-and-restore operation and 
disables clock interrupts. If the KWl1-Y is allowed to run during 
this period, it would time out and cause the alarm to be turned on. 


To save a system with the KW11-Y watch dog timer, perform the 
following steps: 


1. Disable the timer (with switch), 
2. Save the system, and 


3. When the system is up and running, turn the timer on. 
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RMDEMO 


C.1 INTRODUCTION 


RMDEMO is a privileged task that displays information concerning task 
activity in an RSX-11M system. The display usually runs continuously 
on a video terminal with cursor control, such as the VTO5B or the 
VT52. Certain versions of the task will allow a once-only display on 
any record-oriented device. 


The display features include: 
1. Current date and time; 
2. The currently active task; 


3. All tasks, loaded drivers, and common blocks that are 
currently in memory, displayed in a graphic fashion to show 
their individual memory requirements and location relative to 
other tasks; 


4, The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by each group; 


5. The current amount of available system dynamic memory (POOL 
space), including the largest available block and the number 
of fragments; 


6. A graphical display of the partition information; 


7. ‘The number of hours that have elapsed since RMDEMO was 
initiated; and 


8. The number of free blocks available on the system device and 
one Or more additional mounted FILES-11 volumes. 


9. The system error count sequence. 


RMDEMO will scale the display to the memory size of the computer. on 
which it is executed. The amount of memory displayed on the screen 
will always be the next largest power of 2 in K-words. For a 28K 
system, 32K will be displayed. For a 256K system, 256K will be 
displayed and the available memory will just fill the screen. 


Task locations and sizes displayed by RMDEMO should be _ considered 
approximate. RMDEMO is primarily designed to provide a visual display 
and system debugging tool; it should not be used for accurate 
measurement of task size and location. 
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C.2 HARDWARE REQUIREMENTS 


The dynamic version of RMDEMO needs either a VTO5B or a VT52 for its 
constantly changing display. The buffered, once-only version will 
output a single screen image on any record oriented device or 
conditionally to a file. 


RMDEMO will run on either an RSX-11M or RSX-11S_ system. It is 
non-overlaid, and requires approximately 3K for a version that 
Supports only cursor control terminals with all available display 
options included. The largest version that includes all of the above 
plus the ability to output a display image to a file will take 
approximately 7K. 


RMDEMO uses the space between the end of its task image and the end of 
its partition to buffer the screen information. The number of tasks 
and mounted FILES-11 devices for which space is required for RMDEMO to 
execute is set by assembly constants. (The distributed object file is 
configured to require enough space for twenty tasks and two FILES-11 
devices.) If the available space is not adequate for the minimum 
storage requirements configured into the task, whether or not’ there 
are actually that many active tasks or loaded drivers, RMDEMO will 
exit with the message: "INSUFFICIENT TASK LIST BUFFER SPACE. INSTALL 
TASK WITH A LARGER INCREMENT.“ At this point the user has two options: 
first, install RMDEMO in a larger partition; and second, reassemble 
RMDEMO to require space for fewer tasks. Should there be more active 
tasks than the buffer can accomodate, RMDEMO will display as many as 
available space permits. 


C.3 BENEFITS OF USING RMDEMO 


In general, RMDEMO is a useful task designed to allow either an 
operator or a user to view the current state of the operating system. 
The information is presented in a graphic, easily comprehensible form. 


There are a number of specific instances in which RMDEMO can help to 
locate certain system lockout problems or bugs in application and/or 
system-level software. 


1. Bugs and other situations that cause exhaustion of system 
dynamic memory (resulting in unexplained system hangs) may be 
detected and more easily reproduced and diagnosed. 


2. Task checkpointing and swapping may be monitored -- and in 
systems with limited memory, deadlock conditions may often be 
more eaSily diagnosed. 


3. Because RMDEMO provides a real-time view of the free space on 
a number of FILES-1l1 devices, it may be used to monitor 
situations where online storage is at a premium or where some 
program is running wild. 
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C.4 EXPLANATION OF THE OUTPUT 


1 2 3 
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Figure C-l 
Example of RMDEMO Display 


l. The current version number of the system, base level, and 
memory size. 


2. The elapsed time (in hours) since RMDEMO was’) initiated. If 
RMDEMO is initiated in the STARTUP.CMD file, this value 
closely approximates the system UPTIME (i.e. the time since 
the last boot). 


The time is calculated in such a way that it is tolerant to a 
change in the system time caused by use of the TIM command. 
The greatest difference that a TIM command can make to the 
UPTIME figure iS one minute. Further, it is tolerant to 
delays of up to one minute in the execution of the task. 
These delays may occur for a number of reasons, including 
pressing the COPY key on VT52 terminals that are so equipped. 


3. Current date and time. 


4. Currently executing task; *IDLE* indicates that no task is 
executing (the Executive is executing the idle loop). 


5. Pool information. POOL=X:Y:2Z where: 


X = the size of the largest free block in the POOL (in 
words); 

Y = the total number of free words on the POOL; 

Z = the number of fragments in the POOL free list. 


6. Number of free blocks on SY0: and the next mounted FILES-11 
device encountered in scanning the device list. 


7. Number of active tasks in memory, with the amount of memory 
they occupy. Also included are the number of active tasks 
not currently memory resident (i.e., swapped out), with the 
total memory that they would require. 


C=3 


10. 


i 


12. 


ES: 
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Each task in memory is displayed in the “task display" 
portion of the screen. The task name is listed vertically, 
and the memory the task occupies is represented by brackets 
and lines below (or above) the task name. 


The particular form of the brackets and lines used to_ show 
the memory requirements of the task have a special meaning. 


< > means a task is active. 
[ } means a task iS not active, yet occupies 
memory. 


( ) indicates a common area; the name displayed 
is the common name. 


--- means a task is not fixed-in-memory. 
=== means a task is fixed-in-memory. 


Loadable drivers that are loaded. The device mnemonic is 
displayed instead of the task name. 


Partitions in system. The partition name comes first, with a 
letter to show the type of the partition. The letters are 
defined as follows: 


task partiton, 

Subpartition, 

system-controlled (dynamic) partition, 
common partition. 
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Partition tick marks. The beginning of each partition is 
marked by a letter. The letters for the partitions are the 
same as the letters in 10 above, and include the following 
additional information: 


E 
P 


system Executive, 
system POOL space, 
end of physical memory. 


The memory fence. This line shows the end of physical 
memory. If the available memory exactly fills the screen, 
the fence is not displayed. 


The system error count sequence recorded by the error logger. 
If error logging is not included in the system, ERRSEQ is 
always zero. 


C.5 CONFIGURATION OPTIONS 


A number of assembly configuration parameters are available with 


RMDEMO. 


They are detailed more closely in the source of the program. 


They include: 


Support for the VTO5B or VT52. Both object libraries are 
distributed. 


Output one screen image on a standard record-oriented device. 
It may also be generated to output the one screen image to the 
file RMDLOG.LST. Because the output device for the file is 
LSO:, the RMDEMO user must either use the MCR ASN command to 
direct the file to the appropriate disk or modify the source 
code appropriately. 


The IN: and OUT: statistics may be moved to other portions 
of the screen if they overlap the lowest tasks in memory. 
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e The number of FILES-11 devices displayed in the free space 
listing may be changed. 


e The minimum number of tasks for which space is required may be 
changed. 


Additional parameters may be altered to yield different versions of 
RMDEMO. The source file contains extensive comments and should be 
examined for explanations of these features. 
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EXAMPLE SYSGEN 


The following is a console listing from an actual SYSGEN 
on-line using the dual RKO5 distribution kit. 


The Executive features include: 


Files-1l ACP support 

RMS record locking and placement control support 
Checkpointing 

Dynamic checkpoint allocation 

Dynamic memory allocation 

Automatic memory compaction 

Multi-user protection support 

Online user mode diagnostics support 


Loadable device driver support 


This SYSGEN is intended for a mapped system. 


performed 


EXAMPLE SYSGEN 


“SET /UIC=£200%200] 
~@DIK1S PRESYSGEN 


ae fe, 
OM 


FPRESYSGEN <VERSION 03.1> 


COPYRIGHT (C) 1977 
DIGITAL EQUIPMENT CORP.» MAYNARIIy MASS. 01754 


ae af gt 


Ab “E> “Eb “Bh “EP “EP “EP “ED “EP “EP “GP wp “EP “SP “SS WP Gp GP “GP “EP “Ed UP 


"ee 


INITIALIZE SYSTEM FOR DUAL RKOS SYSGEN 


THIS COMMAND FILE WILL PREPARE THE BASLINE DISK FOR USE 
BY THE SYSTEM GENERATION FROGRAMS. 


fous Ns 


THE DUAL RKOS DISTRIBUTION KIT REQUIRES AT LEAST? 


ee 


24K WORDS OF MEMORY» ANID 


“eet 


af a a Se 


ONE RKOS REMOVABLE PLATTER DISK DRIVE, FLUS 
ONE RKOSF FIXED FLATTER DISK ORIVE 

OR 
TWO RKOS REMOVABLE FLATTER INISK DRIVES. 


wu? 


fous 


sk NOES THIS SYSTEM MEET THE ABOVE REQUIREMENTS? [Y/NI2Y 
“SET. /UIC=C1139 


BEFORE STARTING SYSGEN» YOU MUST MAKE A COPY OF THE DISTRIBUTION 
KIT. THIS WILL ENSURE THAT YOUR IDISTRIBUTION KIT IS COMPLETE ANI 
SERVE AS A BACKUF. AS THE BASLINEs EXECSRCy AND SYSTEM DISKS ARE 
ALTERED BY SYSGEN,y IT IS USUALLY NECESSARY TO USE A NEW COFY EACH 
TIME. 


va a 


“a> “a> ~er ar er e> “a> JE D> JE JE ~e> ar er <a> ~em “a> “a> 


HAVE YOU COPIED THE DISTRIBUTION KIT AS REQUIRED? CY/NItY 

IN WHICH RKOS UNIT IS THE BASLINE TNISK MOUNTED? CO R20-37? 1 
SN DKRL?2=Sy3 
~ ARE YOU RUNNING SYSGEN STANTIALONE? CY/NI3N 


nn re 


IN ORDER TO FERFORM A SYSGEN ON-LINE» THE FOLLOWING TASKS MUST BE 
INSTALLED? EDIT» FLX» INI» MACs PIF» TRE» ANT UFD. THESE TASKS MUST 
REMAIN INSTALLED ON THE RUNNING SYSTEM UNTIL. THE SYSGEN FROCESS IS 
COMPLETE. WE WILL FAUSE NOW TO ALLOW YOU TO INSTALL THE REQUIRED 
TASKS. 


AT. ~~ PAUSING. TO CONTINUE TYFE "RES ...AT." 
“RES «++AT. 
AT. ~~ CONTINUING 


SASN DKL2=LB3 

>*k DOES THE RUNNING SYSTEM HAVE TWO REMOVABLE RKOS DISK DRIVES? CY/NIZY 
2% ARE YOU GENERATING A MAPPED SYSTEM? CY/NIAZY 

“SET /UIC=C1954] 

SPIF CiyS4I/RE/NV=C1sSOIBAISYS Xe Kr TSCSYS. KI KePRESRY. KEK 

SPIP ClyeSOIk. Xe xX/DE 

2k ENTER THE UNIT NUMBER OF THE EMPTY RKOS DRIVE CO R:O-3]: 0 


oy 

>» PLACE THE EXECSRC DISK IN DIKO? AND START IT UP CWRITE ENABLED) 
re 

27k IS THE EXECSRC DISK READY? CY/NIZY 

“MOU DKOZEXECSRC 

2ASN [IKO3=SY? 

“SET /UIC=C1:13 

PIF LB? /CO=RSXMAC.SML 


oF 
*% SYSGEN PART 1 “VERSION O3,.1> 
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EXAMPLE SYSGEN 


COPYRIGHT (C) 1975» 1974% 1977 
DIGITAL EQUIPMENT CORF.» MAYNARD» MASS. 01754 


DETERMINE SYSTEM FEATURES ANI! ASSEMBLE THE EXECUTIVE 


ET /UIC=£200%200] 


EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEF IN THIS 
SYSGEN COMMAND FILE. ON THE OTHER HANI!» SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


DO YOU WANT EXPANDED COMMENTS? CY/NIZY 
[tO YOU HAVE THE SINGLE RKOS NISTRIBUTION KIT? CY/NIEN 
tO YOU HAVE THE DUAL RKOS DISTRIBUTION KIT? CY/NICY 


SASN DTIKO?=SY? 
ZSASN DK12=LB? 
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DUE TO DISK SFACE RESTRICTIONS ON THE RKOS DISTRIBUTION KIT 
(ROTH RK [DISK ANI! MAGTAPE KITS) DRIVERS WHICH WILL NOT 
RE USED IN YOUR TARGET SYSTEM MUST BE DELETED. 


HAVE YOU ALREADY DELETED THE DRIVER SOURCE MODULES? CY/NIIN 


WE WILL NOW DELETE THE UNUSED DRIVER MODULES. THIS WILL MAKE 
ROOM FOR COMPLETING THE SYSGEN ANDI ALSO ROOM FOR CORRECTIONS 
TO THE EXECUTIVE WHICH ARE FUBLISHED IN THE SOFTWARE 
DISPATCH. IN GENERAL THIS WILL NOT CAUSE PROBLEMS 
SINCE RSX11M SUFPFORTS A NUMBER OF PERIPHERAL DEVICES 
WHICH HAVE BEEN SUPERSEDED BY THOSE OF NEWER DESIGN. 
FOR EXAMPLE 3 
IF YOU HAVE AN RPO4/05/06 YOU FROBABLY DON’T HAVE AN RFRO2/03 
IF YOU HAVE AN RSO3/RSO04 YOU FROBABLY DION’T HAVE AN RF11 
IF YOU HAVE A TU16/45 YOU FROBABLY DON’T HAVE A TULO 
IF YOU HAVE A IMC11 YOU FROBABLY DON’T HAVE A [rAL11~-B 
ANT SO ON. 


IF AT A LATER DATE» YOU ACQUIRE A DEVICE WHOSE DRIVER HAS BEEN 
DELETED FROM THIS ISK» YOU CAN EASILY RETRIEVE IT FROM THE 
ORIGINAL DISTRIBUTION DISK AND FUT IT ON THIS fISK. 


“SET /UIC#E119101 


ok 


lo YOU HAVE ANY ATO1-0 A/D CONVERTER CONTROLLERS? CY/NIEN 


SPIP ADIIRV. MAC #X/TIE 


2k 


ANY AFC11 A/T CONVERTER CONTROLLERS? CY/NIEN 


SFIF AFIIRV. MAC $ X/TE 


2X 


ANY ARL1 LABORATORY PERIPHERAL SYSTEM CONTROLLERS? CY/NJ?N 


PIP ARTIRV. MACs X/TE 


XK 


ANY CRLII/CM11 CARD READER CONTROLLERS? CY/NI¢N 


SPIF CRORY. MAC § X/TE 


ok 


ANY TAL1/TU6O CASSETTE DRIVES? CY/NIEN 


SPIP CTORY. MAC #X/TE 


ok 


ANY RJ/RWPO4/05/06 DISK NRIVES? CLY/NI3N 


“PIP TBIRV. MACs x/TIE 


ok 


ANY RFii FIXED HEAD DISK DURIVES? CY/NIi2N 


“PIP DFDRV. MACs k/DE 


2k 
mk 


ANY RRIL/RKO3/05 ISK DRIVES? CY/NIULY 
ANY RLII/RLOL ISK DRIVES? CY/NIIN 


OPIF TILIIRVY. MACs k/TIE 


xk 
=k 


ANY RK611/RK06 DISK DRIVES? CY/NITY 
ANY RFLL/RERO2/RFOS DISK DRIVES? CY/NISN 


SPIP DPORV. MAC? K/TE 


ok 


ANY RWMOS DISK DRIVES? LY/NIIN 


oFPIF DORDRY.MAC$ X/DE 


ok 
Roe. 
ok 


ANY RJ/RWS03/04 FIXED HEAD DISK DRIVES? CY/NIALY 
ANY TC11/TUS46 DECTAFE NIRIVES? CY/NIZY 
ANY RX11/RX0O1 FLOPFY DISK DRIVES? CY/NALY 


OK ANY VTLI/VS60 GRAPHICS DISPLAYS? LY/NIIN 


EXAMPLE SYSGEN 


SPIF GRORV. MACs X/TE 

2K ANY LFAL1 LABORATORY PERIFHERAL ACCELERATORS? CY/NIJ2N 
SPIF LADRV.MACe K/TE 

2K ANY LPLI/SLSLI/LV11/L A180 FRINTERS? CY/NIZY 

2k ANY LFS11 LABORATORY FERIFHERAL SYSTEMS? CY/NI2N 
SPIF LSOURV.MACs X/DE 

2K ANY TJI/TWUL6/45/TE146 TAFE DRIVES? CY/NIZY 

2k ANY TMLII/TULO/TELO/TSO3 TAPE DRIVES? LY/NIZY 

2K ANY PC11 FAPER TAFE READER/PUNCHES? CY/NIEN 

PIP PRPORV. MACs X/DE 

2k ANY FPRIL PAPER TAFE READERS? CY/NI3N 

SPIF PRORV. MAC? X/DE 

2K ANY ICR/ICS11 INDUSTRIAL CONTROLLERS? CY/NIIN 
PIF ICORV.MAC#X/TE»sICOM.MAC eX 

2k ANY DRS/NSS11 DIGITAL INFUT/OUTFUT MODULES? CY/NIIN 
“PIF ISQRYV.MAC#*/DEyISCOM. MACS k»NSSUI.MACs xk 

>* ANY UDNC11 UNIVERSAL INDUSTRIAL CONTROLLERS? CY/NIIN 
SPIP UDDRY. MACs X/TE »U0COM,. MAC #x 

2K ANY TALI-B UNITBUS LINKS? CY/NIIN 

OPIF XBOURV.MAC ¢ X/TIE 

2X ANY DLAII-E ASYNCHRONOUS LINES? CY/NIEN 

SPIF XLURV.MAC ¢ X/TIE 

2K ANY DMC11 INTERFROCESSOR LINKS? CY/NIIN 

SPIF XMORV. MAC 9 K/TE 

2K ANY DPLL SYNCHRONOUS LINE INTERFACES? [CY/NItN 
SEIF XPORY,MACs X/DE 

2K ANY DQ11 SYNCHRONOUS LINE INTERFACES? CY/NI¢N 
SPIF XQURU.MAC 9 X/DE 

2K ANY DULL SYNCHRONOUS LINE INTERFACES? CY/NIIN 
SEIP XUDQRY. MAC #x/ TE 

=k ANY DUFAL SYNCHRONOUS LINE INTERFACES? EY/NITEN 
SPIF XWOIRV.MAC® K/TIE 

SSET /UTC#£200%200] 

PIF SYSGENO.CMDIs X/TE 

2k ARE YOU BUILDING AN RSX-11S SYSTEM? CY/NIIN 

ARE YOU BUILDING A MAFFED SYSTEM? CY/NI7Y 


ARE YOU RUNNING ON A MACHINE WITH A LINE PRINTER? CY/NIGY 
IS IT A 132. COLUMN LINE PRINTER? CY/NITZY 

WILL YOUR SYSTEM INCLUDE 0SS-11 SUPPORT? CY/NAtN 

WILL YOUR SYSTEM INCLUDE ICS/ICK<-11 SUPPORT? CY/NAIN 

=k WILL YOUR SYSTEM INCLUDE U0C-11 SUPPORT? CY/NIIN 

SET /UTCHEL LI» 107 


Se ee ee ae ee 


ea 


FEATURES AND PERIPHERAL DEVICES WE WANT IN THE NEW SYSTEM. 


SYSGEN FROMNUCES INDIRECT FILES WHICH ARE SUBSEQUENTLY USED 


id 
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TIME CONSUMING ANI IS NOT RECOMMENDED, ESPECIALLY IF THE 
ASSEMBLER IS BEING USED CWHICH IT MUST BE ON A 16K SYSTEM). 


s 


ASSEMBLY LISTING FILES TESTRED? CY/NIIN 


PARTITIONS ANT DLAGNOSING SYSTEM FAILURES REQUIRE THIS MAF. 


“fs 


TASK BUILDER MAF DESTRED? CY/NIZY 


ke Re Re SP ae ae AS SP ae Ss a ee as 4 Ge ee Se * 


SYO FOR THE MAP TEVICE. 
WHAT IS TO BE THE MAF DEVICE? Conud CSa: syo 


SFOOLING WILL ONLY ACTUALLY OCCUR FOR DIRECTORY DEVICES. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORKS? CY/NITY 


NOW WE BEGIN THE SYSGEN QUERY SECTION TO SELECT THE EXECUTIVE 


LONG DIALOGUE DESIRED FOR EXECUTIVE/FROCESSOR OFTIONS? CY/NISY 


ASSEMBLE THE USER-TAILORED EXECUTIVE. LISTING FRODUCTION IS 


A TASK BRUILTER MAF IS STRONGLY RECOMMENDED, ESTABLISHING 


FOR ALL OISTRIBUTION KITSs IT IS RECOMMENDED THAT YOU SFECIFY 
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EXAMPLE SYSGEN 


NOTE THAT THE BASELINE SYSTEM TIOES NOT INCLUDE A FRINT SPOOLER. 
SPOOL MAP FILE? CY/NIZY 


THE PRECEDING QUERIES 0 NOT AFFECT THE USER~-TAILORED 
EXECUTIVE. THE EXECUTIVE OPTION QUERIES THAT FOLLOW WHICH ARE 
PRECEDED BY A SINGLE ASTERISK ARE INCLUDED IN THE BASELINE 
SYSTEM. THE FEATURE» HOWEVER» IS NOT ESSENTIAL TO THE 
OPERATION OF A MINIMUM SYSTEM. DOUBLE ASTERISKED QUERIES MUST 
BE SELECTED FOR FULL SUFFORT OF THE MINIMUM SYSTEM. QUERIES 
WITH NO ASTERISKS ARE NOT IN THE MINIMUM SYSTEM ANID ARE 
OF TIONAL. 


REGIN EXECUTIVE SERVICE OFTIONS. 
FAILURE TO INCLUDE THIS OF TION ELIMINATES ALL THE SERVICES 
DESCRIBED IN THE RSX-11 1/0 OFERATIONS REFERENCE MANUAL. SINCE 
DEC SUPPLIED SOFTWARE MAKES USE OF THESE SERVICES» THEIR 
ELIMINATION IS NOT RECOMMENDET, 
*KDO YOU WANT FILES~11 ACP SUPPORT? CLY/NILY 


THIS OFTION IS REQUIRED IF YOU WANT RMS~-11 RECORD LOCKING 
(SHARED WRITE) ANDT/OR FLACEMENT SUPFORT. 


no YOU WANT RMS RECORE LOCKING ANID FLACEMENT CONTROL SUFFORT? CY/NItY 


IF TASKS ARE TO BE DISPLACED FROM A PARTITION TO YIELD THE 
FROCESSOR RESOURCES TO A TASK OF HIGHER FRIORITY ABLE TO USE 
THE FPARTIYIONy THEN CHECKFOINTING IS REQUIRED. 


xxTIO YOU WANT CHECKPOINTING? CY/NITZY 


SELECTION OF THIS OF TION ALLOWS CHECKFOINTING INTO A SYSTEM 
CHECKFOINT FILE RATHER THAN REQUIRING SPACE IN EACH TASK IMAGE. 


00 YOU WANT TIYNAMIC CHECKPOINT ALLOCATION? LY/NILY 

THIS OPTION ALLOWS AS MANY TASKS AS WILL FIT IN A FARTITION TO 
BE SIMULTANEOUSLY RESITENT. THE ALLOCATION OF FARTITION MEMORY 
TS AUTOMATIC ANDI! IS CARRIED QUT DYNAMICALLY BY THE RSX—11M 
EXECUTIVE, 

NO YOU WANT DYNAMIC MEMORY ALLOCATION SUPPORT? CY/NISY 


AUTOMATIC MEMORY COMPACTION MINIMIZES THE EFFECTS OF 
FRAGMENTATION IN D[IYNAMICALLY ALLOCATEL FARTITIONS. IT IS 


“INVOKED «WHEN FREE SPACE EXISTS BETWEEN RESIDENT 


NONCHECKPOINTABLE TASKS AND TASKS ARE WAITING TO BE LOATED 
INTO THE PARTITION. 


NO YOU WANT AUTOMATIC MEMORY COMFACTION? CY/NISY 


THE MEMORY MANAGEMENT DIRECTIVES PFPROVITE TASKS WITH A 
FROTECTED! MECHANISM BY WHICH THEY CAN DYNAMICALLY CREATE ANI 
TELETE COMMON BLOCKS ANID DYNAMICALLY MODIFY THEIR FHYSICAL 
AQNTIRESS SFACE MAFFING. 


NO YOU WANT THE MEMORY MANAGEMENT DUITRECTIVES? CY/NIEN 


MULTI-USER PROTECTION FREVENTS ONE USER FROM INTERFERING WITH 
THE OPERATION OF ANOTHER BY FROVIDING FOR FUBLIC ANI PRIVATE 
QEVICE OWNERSHIF ANID LOGON/LOGOFF WITH FASSWORD FROTECTION. 
SELECTION OF THIS FEATURE AUTOMATICALLY INCLUDES TERMINAL. 
QRIVER SUPPORT FOR REAM WITH SPECIAL TERMINATOR: BREAKTHROUGH 
WRITE» AND REAL WITH NO ECHO. 
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EXAMPLE SYSGEN 


NO YOU WANT MULTI-USER PROTECTION SUPPORT? CY/NIZY 


SELECTION OF ANSI MAGTAPE SUPPORT FROVIDES VOLUME AND FILE 
LABELING WHICH CONFORMS TO THE ANSI STANDARD FOR INDUSTRY 
COMPATIBLE TAPE. THIS OPTION REQUIRES EXECUTIVE AST SUPFORT. 


TQ YOU WANT ANSI MAGTAFE ACF SUPPORT? CY/NI2N 


USER MODE DIAGNOSTIC SUPFORT ENABLES THE EXECUTIVE ANN DEVICE 
DRIVERS TO SERVICE SPECIAL I/0 FUNCTIONS ANT RETURN ANDITIONAL 
DEVICE STATUS INFORMATION AS REQUIRED BY ONLINE DIAGNOSTIC 
TASKS. 


TO YOU WANT SUFFORT FOR ONLINE» USER MODE DIAGNOSTICS? CY/NIZY 


LOADABLE DEVICE URTVER SUPPORT ALLOWS MOST DEVICE DRIVERS TO 

RE REMOVED FROM THE EXECUTIVE. THEY CAN BE LOADED ANT UNLOADEN 
ALMOST AT WILL. AT THIS POINT ONLY THE FROCESS CONTROL DRIVERS 
CUNC» ICS/ICR» AND URS/OSS DRIVERS) AND THE YVT11/V¥S60 GRAPHICS 
QRIVER CAN NOT BE LOADABLE. LOADING OF THE TERMINAL RIVER IS 

RESERVED FOR VMR LOAT. 


NOTE? LOADABLE URIVER SUPPORT IN RG&X-115 ITS LIMITED TO VMR. 
*NQ YOU WANT LOADARLE DEVICE DRIVER SUPPORT? CY/NISY 
AS DISTRIBUTED, THE RSX-11M SQURCE ISK FROVITES FOR THE 


GENERATION OF AN RSX-11M OR RGX-118 EXECUTIVE THAT CONTAINS 
SUPPORT FOR NETWORK COMMUNICATIONS. IN ORDER TO GENERATE SUCH 


‘A SYSTEM YOU MUST HAVE THE APPROPRIATE NETWORK SOFTWARE 


LICENSE. 
NO YOU WANT NETWORK ACF SUPPORT? LY/NIIN 


IF YOU INTEND TO USE THE K-SERTIES LAR FERIPHERALS SUPFORT 
ROUTINES» THE I.PALI LAR. FERTFHERAL ACCELERATOR: THE PRINT 
SFOOLER» THE FORTRAN ISA PROCESS CONTROL SUBROUTINE CALLS» 
ANSI MAGTAFEs OR UNSOLICITED TERMINAL AST’S» THEN 
ASYNCHRONOUS SYSTEM TRAF FROCESSING SUFFORT IS REQUIRED. 

SEE THE EXECUTIVE REFERENCE MANUAL FOR A DETAILED NESCRIFPTION 
OF THE AST FACILITY PROVIDEN IN RSX~11M/S. 


QQ YOU WANT AST SUPPORT? CY/NILY 
ABNORMAL TASK TERMINATION AND DEVICE NOT READY MESSAGES ARE 


AUTOMATICALLY PRODUCED BY THE SYSTEM IF THIS OPTION IS 
SELECTED. THIS OPTION IS REQURED IF FMD SUPFFORT IS DESIRED. 


*xDQ YOU WANT TASK TERMINATION ANID DEVICE NOT READY MESSAGES? CY/NIZY 


IF THE FOWER FAILS ANI THIS OF TION ITS INCLUDEDys SYSTEM OPERATION 
TS AUTOMATICALLY COMMENCED WHEN FOWER IS RESTORED, 


NO YOU WANT POWERFATL RECOVERY? CY/NIEN 


REQUIRED IF DEC SUPPLIED FROGRAM DEVELOPMENT SOFTWARE (CIE. 
TKEy MACs ETC.) IS TO BE RUN. 


KxXDOQ YOU WANT GET FARTITION FARAMETERS DNTRECTIVE? CY/NI¢Y 

THIS QNIRECTIVE PROVINES THE CAPABILITY TO REAN THE PROCESSOR 
SWITCH REGISTER ANT RETURN ITS CONTENTS TO THE REQUESTING TASK. 
NOTE THAT SOME PROCESSORS DQ NOT HAVE A CONSOLE SWITCH REGISTER 
AND: THEREFORE» CANNOT SUPPORT THIS DIRECTIVE. 

NO YOU WANT GET SENSE SWITCHES DIRECTIVE? CY/NISY 


REQUIRED IF EC SUPPLIED PROGRAM TEVELOPMENT SOFTWARE (I.E. 
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EXAMPLE SYSGEN 


TKBy MACs ETC.) IS TO RE RUN. 
*XIIO YOU WANT GET TASK PARAMETERS DIRECTIVE? CY/NILY 


THESE UTRECTIVES PROVINE THE CAPABILITY FOR COOPERATING TASKS 
TO COMMUNICATE VIA SYSTEM MAINTAINED MESSAGE QUEUES. IF THE 
TARGET SYSTEM WILL CONTAIN THE FRINT SFOOLER» OR IF LFPALI-K 
FOWERFAIL SUPFORT OR ANSI MAGTAFE SUPPORT IS DESIREN, THIS 
OPTION MUST BE INCLUNED, 


NO YOU WANT SENTII/RECEIVE NIRECTIVES? LY/NIZY 
THIS DIRECTIVE ALLOWS A TASK TO ALTER ITS OWN OR ANOTHER TASK‘S 
PRIORITY AT EXECUTION TIME. ITS INCLUSION WILL ALSO ALLEVIATE 
THE FROBLEMS WITH ABORTED» NON-RESINENT TASKS. 


nO YOU WANT ALTER PRIORITY NIRECTIVE? CY/NICY 


THIS DIRECTIVE ALLOWS A TASK TO CONNECT AN INTERRUPT VECTOR 
TO AN INTERRUFT SERVICE ROUTINE IN ITS OWN SFACE. TT IS REQUIRED 


IF K-SERIES LABORATORY PERIFHERALS SUPFORT IS DESIRED, 
10 YOU WANT CONNECT TO INTERRUPT VECTOR DIRECTIVE? CY/NIIN 


THIS DIRECTIVE ALLOWS A TASK TO INCREASE ITS ADDRESS SPACE AT 
EXECUTION TIME. 


NO YOU WANT EXTENT! TASK INIRECTIVE? CLY/NIZY 


SELECTION OF THIS OFTION WILL SIGNIFICANTLY INCREASE SYSTEM I70 
THROUGHFUT AT THE EXPENSE OF ANNITIONAL EXECUTIVE CONE. 


NO YOU WANT QUEUE I/0 SFEED OPTIMIZATIONS? CY/NIZY 


I/O THROUGHPUT IS ENHANCED BY FPRE-ALLOCATING A NUMBER OF 1/0 
FACKETS FROM THE FOOL» LEAVING THEM AVAILABLE FOR QUICK USE RY 


QUEUE 170, 


HOW MANY I/O FACKETS SHOULD BE PRE-ALLOCATEN? CO R31.-15.13% 15 


AN ADDITIONAL SFEED IMPROVEMENT IS ACHIEVED BY OPTIMIZING DNATA 
TRANSFERS IN THE EXECUTIVE MODULE ’BLXIO’. ONE IMPROVEMENT IS 
THE USE OF A SERIES OF ‘MOV’ INSTRUCTIONS WHICH IS USED IN LIEU 
OF A LOOP. THIS IS CALLED THE DATA TRANSFER VECTOR. 


ENTER SIZE OF DATA TRANSFER VECTOR IN WORDS CO R24.-33.13 33 


THIS FACILITY OF MCR CAN SURSTANTIALLY REDUCE THE NUMBER ° OF 
INSTALLED TASKS NEENER FOR CONVENIENT SYSTEM OPERATION. SEE 
DESCRIPTION OF THE RUN COMMAND IN THE RSX-11M OPERATOR’S 
PROCEDURES MANUAL FOR DETAILS. 


x00 YOU WANT INSTALL» REQUEST, ANT REMOVE ON EXIT SUPPORT? CY/NIAZY 


LOGICAL NEVICE ASSIGNMENT FROVINES THE CAFABILITY TO ASSOCIATE 
A LOGICAL NAME TO A FHYSICAL DEVICE UNIT. ASSIGNMENTS MAY RE 
MALE ON A FER TERMINAL OR SYSTEM WITE RASTIS. 


*xNQ YOU WANT LOGICAL TIEVICE ASSIGNMENT SUPFORT? CY/NIT2Y 


THE NULL DEVICE WILL ALWAYS RETURN THE I70 STATUS FOR SUCCESS~— 
FUL COMPLETION FOR AN OUTPUT REQUEST AND) END-OF-FILE FOR AN 
INPUT REQUEST. IT IS VERY USEFUL TO ASSIGN IT AS THE OUTPUT 
QEVICE WHEN USING PRE-WRITTEN COMMAND FILES FOR WHICH CERTAIN 
TYPES OF QUTFUT SHOULD BE SUPPRESSED, THE NULL DEVICE DRIVER 
TS NOT LOADABLE. 


x00 YOU WANT A NULL DEVICE? CY/NILY 
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EXAMPLE SYSGEN 


THE USER ORTENTED TERMINAL URTVER CONTAINS THOSE FEATURES FOUND 
MOST DESTRABLE BY USERS ON A PROGRAM DEVELOPMENT SYSTEM. THE 
FOLLOWING FEATURES ARE INCLUDET 3 


~ AUTOMATIC CARRIAGE RETURN/LINE FEET 

~ BREAKTHROUGH WRITE 

~ TASK CHECKPOINTING DURING TERMINAL INFUT (NEEDS EXEC SUPPORT) 
~ UNSOLICITED INFUT CHARACTER AST (NEES EXEC SUPFORT) 
~ WRITE WITH CONTROL-O CANCELLATION 

~ CONTROL-R SUPFORT 

- GET TERMINAL CHARACTERISTICS 

~ GET TERMINAL DRIVER SUPPORT 

~ SETTABLE CASE CONVERSION 

~ READ WITH NO ECHO 

~ READ AFTER PROMPT 

~ SPECIAL CHARACTER LINE TERMINATOR SUF FORT 

~ CRT RUBOUT 

~ TERMINAL -HOST SYNCHRONIZATION 

~ TRANSPARENT TERMINAL REAL/WRITE 

~ VARTABLE LENGTH INFUT BUFFERING 


IF MORE OR FEWER FEATURES ARE DESIRED» ANSWER NO. 
NO YOU WANT THE USER ORTENTED TERMINAL DIRTVER? LY/NIALY 


THE TERMINAL DRIVER NORMALLY CONVERTS A FORM FEED INTO 8 LINE 
FEEDS. CHOOSING THE NEXT OFTION WILL SUPFRESS THIS CONVERSION. 


IF YOU HAVE AN LAL2ZO OR LAIBOS»s YOU MUST ANSWER YES TO THE NEXT 
QUESTION. 


NO YOU WANT FORM FEEDS FASSED DIRECTLY TO TERMINALS? CY/NIEN 


IT IS FOSSIBLE TO GENERATE AN EXECUTIVE LARGER THAN 16K TO 
INCREASE THE SIZE OF THE EXECUTIVE DYNAMIC STORAGE REGION. 
NOING THIS WILL REDUCE THE SIZE OF PRIVILEGED TASKS WHICH MAF 
INTO THE EXECUTIVE TO 8K, 


NO YOU WANT SUPFORT FOR A 20K EXECUTIVE? [Y/NI2Y 


ROUND ROBIN SCHEDULING FROVITIES THE CAPABILITY FOR A GROUP OF 
RESIQNENT TASKS WITHIN A RANGE OF FRIORITIES TO SHARE THE 
AVAILABLE FROCESSING TIME. EACH FRIORITY CLASS WITHIN THE RANGE 
IS ROUND ROBIN SCHEDULED AT EACH SCHENULE INTERVAL CTIME SLICE). 


DO YOU WANT EXECUTIVE LEVEL ROUNT! ROBIN SCHETULING? CY/NIUZY 


ROUND ROBIN SCHENULING IS EXECUTE ON A PERIONIC BASIS. 
A TYPICAL SCHENULING INTERVAL. TS ON THE ORDER OF 100 
MILLISECONDS (6 CLOCK TICKS FOR A 460 CYCLE LINE FREQUENCY 
CLOCK). 


ENTER LENGTH OF SCHEDULE INTERVAL IN TICKS Ch R31.-1000. Tedé. 7: 


ROUND ROBIN SCHEDULING IS EXECUTED FOR A RANGE OF FRIORITY 
CLASSES. TYPICAL RANGES ARE 1. TO 100. 


ENTER HIGHEST PRIOR. CLASS TO BE CONSIDERED Co R 


C21.4-249.73 150 
ENTER LOWEST PRIOR. CLASS TO BE CONSIDERED CO Rel. 


1.-150.72 1 

THE DISK SWAFFING ALGORITHM FROVITNES FOR THE VARIATION OF A 
RESIDENT TASK’S EFFECTIVE PRIORITY WHEN IT IS BEING CONSTQNERETD 
FOR CHECKPOINTING. @ TASK’S EFFECTIVE PRIORITY IS DETERMINET! 
RY BIASING ITS RUN FRIORITY WITH A FOSTTIVE SWAPFFING PRIORITY 
EACH TIME IT IS LOADED INTO MEMORY (EG. INITIAL TASK LOAD OR 
MHECKFOINT READ. AS THE TASK CONTINUES TO RESIDE IN MEMORY» 
ITS SWAPFING FRIORITY BECOMES NEGATIVE? EVENTUALLY REACHING 
A LOWER BOUND? IT IS THIS BIAS WHICH TS USED TO TNETERMINE 


a ne 
wf as Ons vous 


wf ee a te 


oe 


os ae ag ae ae 


Se eg a Ne ae Oe a Oe ae ee ee ee ee a ee a a ee er ee ee ae ae a er ee A a Ue ee er oe er ae ae ee Oe ee 


“A> OP ~ee Or ay an “C> “er JE a> a> ver a> “eo “er BE E> er ar ~ar er E> Er JE E> er en “E> “E> JE en “er ar rer ar “Or “E> SE er <a> wer er E> ~e> JE “E> “a> “Er <a> war ~er <a ~er “E> “a> JE ar ‘en ar wen cen “E> “Er SE wer ~ar es ee 


nS ose 


EXAMPLE SYSGEN 


EFFECTIVE FRIORITY. EVENTUALLY» THE TASK BECOMES ELIGIBLE FOR 
CHECKPOINTING BY TASKS OF EQUAL FRIORITY WHICH ARE NOT RESIDENT 
(OR BY LOWER FRIORITY TASKS WITHIN THE SFECIFIED RANGE). 


DO YOU WANT EXECUTIVE LEVEL [ISK SWAPFING? CY/NITY 


SWAFPING FRIORITIES ARE DECREMENTED ON A FERIONIC BASIS. 

A TYPICAL TIME INTERVAL IS ON THE ORDER OF S00 MILLISECONDS (30 
CLOCK TICKS FOR A 60) CYCLE FREQUENCY CLOCK). TYPICALLY» THE 

SWAPPING INTERVAL SHOULD BE AT LEAST S TIMES THE ROUND RORIN 

SCHEDULING INTERVAL. 


ENTER LENGTH OF SWAFFING INTERVAL IN TICKS CD Rt1.-5000. Mi30,.73 30 


WITH A SWAFFING FRIORITY OF "S"s A TASK RUNNING AT FRIORITY 
"P*® WILL HAVE AN EFFECTIVE FRIORITY RANGE (FOR CHECKFOINTING ) 
FROM "FtS" TO ‘“‘F-S" AS LONG AS ITT RESINES IN MEMORY. THE 
SWAPPING FRIORITY FETERMINES THE RANGE OVER WHICH LOWER 
FRIORITY TASKS MAY CHECKPOINT HIGHER ONES? THE LARGER THE 
SWAPPING FRIORITYs THE GREATER THE RANGE. 


A TYPICAL VALUE FOR THIS FARAMETER IS S. 

WHAT IS THE SWAPFING FRIORITY? CO Rii.-20. U25.7¢ 5 

AQNNITION OF A USER WRITTEN DRIVER REQUIRES THAT ATEQUATE SPACE 
RE ALLOCATED FOR INTERRUFT VECTORS DURING THE ASSEMRBI.Y OF THE 
SENERATEL EXECUTIVE. ACTUAL DRIVER INCLUSION OCCURS WHEN THE 
TARGET EXECUTIVE IS BUILT. 

ARE YOU PLANNING TO INCLUDE A USER WRITTEN TIRIVER? CY/NIEN 


THE EXECUTIVE DEBUGGING TOOL FROVINES A SUBSET O0T-11 THAT RUNS 
AS A FART OF THE RSX-11M EXECUTIVE. THIS TOOL ALLOWS 


INTERACTIVE EBUGGING OF EXECUTIVE MODULES» I70 DRIVERS, ANI! 


INTERRUPT SERVICE ROUTINES. SELECTION OF THIS OFTION ALSO 
INCLUDES CONSISTENCY CHECK CODE IN THE TIYNAMIC MEMORY ROUTINES. 


no YOU WANT TO INCLUDE THE EXECUTIVE DEBUGGING TOOL? CY/NI:Y 


IF THE SYSTEM CRASHES ANT THIS OF TION IS INCLUDED s THE 
EXECUTIVE STACK ANDI REGISTERS WILL BE DUMPED TO THE SELECTED 
NEVICE. 


LO YOU WANT REGISTER AND STACK DUMP AT SYSTEM CRASH? LCY/NI3Y 


THE DEVICE ON WHICH THE STACK AND REGISTER DUMP AFPEARS 
MUST BE A TERMINAL OF LINE FRINTER COMPATIBLE DEVICE THAT 
IS» IT MUST RECEIVE A SINGLE BYTE AT A TIME. THE NORMAL. 
HEVICE IS THE CONSOLE TERMINAL WHICH HAS A CSR ANDRESS OF 
177564, 


ENTER DUMF DEVICE CSR ANDRESS CO Rt160000-177700 Dti?7564)i 177564 


SELECTION OF THIS OF TION INCLUDES CODE TO DUMP MEMORY TO 
SECONDARY STORAGE FOR LATER ANALYSIS BY THE CRASH DUMP 
ANALYSIS FROGRAM, THE CRASH TUMF DEVICES SUPPORTED ARES 
NTs DiKy MT» ANTI MM. 


lO YOU WANT CRASH DUMP ANALYSIS SUPPORT? EY/NA¢Y 


THE DEVICE ON WHICH THE CRASH NOTIFICATION APPEARS MUST BE A 
PAPER TAFE, TELETYPE: OR LINE PRINTER COMPATIBLE DEVICEs THAT 
TS» THE DEVICE MUST TRANSMIT A SINGLE BYTE AT A TIME. THE 
NORMAL CRASH OUTPUT DEVICE IS THE CONSOLE TERMINAL WHICH HAS A 
CSR ANDRESS OF 177544. 
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EXAMPLE SYSGEN 


IN RESFONSE TO THE NEXT QUESTION» ENTER THE CSR ADDRESS OF THE 
NEVICE ON WHICH THE CRASH NOTIFICATION IS TO APPEAR. 


ENTER OUTFUT DEVICE CSR AIMRESS CO R2160000-177700 02177564]! 177564 


MEMORY CAN BRE TNUMPED ONTO ANY OF THE FOLLOWING DEVICES? 
DT, DiKy MT» MM 


ENTER CRASH MEMORY DUMP TIEVICE MNEMONIC CSI: OT 
WHAT IS ITS CSR ANDRESS CO R2160000-177700 0217734213 


17 
WHAT IS THE PHYSICAL UNIT NUMBER OF CRASH UNIT CO R20-7 


7 
NsO12 0 


SELECTION OF ERROR LOGGING WILL CAUSE DISK AND TAPE DEVICE 
ERRORS TO BE INTERCEPTED ANT INFORMATION CONCERNING THEM TO RE 
WRITTEN INTO A DISK FILE FOR LATER ANALYSIS. NOTE THAT THIS 
OPTION AUTOMATICALLY INCLUDES SUPPORT FOR CHECKFOINTING ANID THE 
SEND/RECEIVE DIRECTIVES, 


tO YOU WANT DEVICE ERRORS ANI TIMEQUTS LOGGEN? LY/NISY 


SELECTION OF THIS OFTION ALLOWS THE EXECUTIVE TO DETECT THE 
OCCURRENCE OF TRAFS TO UNUSED INTERRUFT VECTORS AND TO STORE 
INFORMATION ABOUT. THEM IN A FILE FOR LATER ANALYSIS. INCLUDING 
THIS OFTION ALSO REQUIRES SUPPORT FOR SEND/RECEIVE DIRECTIVES 
ANID CHECKFPOINTING. 


NO YOU WANT UNDEFINED INTERRUPTS LOGGED? CY/NIZY 
SELECTION OF THIS OFTION WILL CAUSE CACHE ANT! MEMORY PARITY 
ERROR TRAPS FROM USER TASKS TO BE INTERCEPTED WITH INFORMATION 
CONCERNING THEM TO BE WRITTEN INTO A FILE FOR LATER ANALYSIS. 
NOTE THAT THIS OFTION ALSO INCLUDES SUPFORT FOR FARITY MEMORY» 
CHECKPOINTING, ANTI THE SENU/RECEIVE UIRECTIVES. 
NO YOU WANT FARITY ERROR TRAFS LOGGEN? CY/NIZY 
A NON ZERO RESPONSE TO THIS QUERY IS REQUIRED. A MINIMUM OF 
256 WORDS WILL BE ACCEFTEN TO INSURE MINIMUM OPERATIONS. 1024 
WORDS IS A REASONABLE ESTIMATE FOR ADEQUATE FERFORMANCE OF A 
SET OF USER TASKS MAKING FULL USE OF THE BASELINE SYSTEM, 
RESPONSE LIMITS! 256.-16384. MINUS SIZE OF EXECUTIVE 
XXENTER SIZE OF DYN. STORAGE REGION IN WORDS CY! R2256.-146384.]2 1024 
IF SELECTED, THE SYSTEM WILL» WHEN IDLE, CAUSE THE [ATA LIGHTS 
TO FLICKER IN A FRONOUNCED CIRCULAR ROTATION. THE OFTION 
FUNCTIONS FROFERLY ONLY ON-POF-11/45/50/55/70 SYSTEMS. 
NO YOU WANT ROTATING FATTERN IN DATA LIGHTS? CY/NAT:Y 

END EXECUTIVE SERVICE OFTIONS. 

REGIN PROCESSOR OFTIONS. 
THE FIP-11/70 REQUIRES ALMITIONAL EXECUTIVE SUPPORT IF You 
WISH TO UTILIZE MEMORY ABOVE 124K, 
IS YOUR TARGET FROCESSOR A FOF-11/70? CY/NILY 
THE MINIMUM MEMORY IS 16K FOR AN RSX-11M SYSTEM ANTI 8K FOR AN 


RSX-11S SYSTEM. THE MAXIMUM MEMORY SIZE IS 1920K FOR AN 
RSX~11M SYSTEM AND 124K FOR AN RSX-11S SYSTEM. IN ORDER TO 


UTILIZE MEMORY ABOVE 28K THE TARGET SYSTEM MUST CONTAIN A 


MEMORY MANAGEMENT UNIT. 


ENTER SIZE OF FHYS. MEMORY IN 1024 WORT BLOCKS CO R$1i6.-1920.1! 124 
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EXAMPLE SYSGEN 


THE POP-11 FLOATING FOINT FROCESSOR IS AN OPTIONAL ARITHMETIC 
PROCESSOR. IT PERFORMS ALL FLOATING FOINT ARITHMETIC 
OPERATIONS AND CONVERTS DATA BETWEEN INTEGER AND FLOATING FOINT 
FORMATS. THIS OPTION IS AVAILABLE. ON THE FDP11/34/45/50/55» 

60 ANI 70. THIS SHOULT) NOT BE CONFUSED WITH THE FIS 

(FLOATING INSTRUCTION SET) OFTION AVAILABLE WITH THE POF11/40. 


DO YOU WANT FLOATING FOINT PROCESSOR SUPPORT? CY/NI°Y 
RSX-11M/S REQUIRES A REAL TIME CLOCK FOR ITS OPERATION. EITHER 
THE KW11-P PROGRAMMABLE FREQUENCY OR THE KW11-L LINE FREQUENCY 
CLOCK OR THE f1L11-W LINE FREQUENCY CLOCK/CONSOLE INTERFACE MAY 
BE USED, 

NO YOU HAVE A FROGRAMMABLE CLOCK? CY/NI3N 


LINE FREQUENCY IS EITHER 50 OR 60 HERTZ. IN THE U.S.A. LINE 
FREQUENCY IS ALWAYS 60 HERTZ. 


IS YOUR LINE FREQUENCY SO HERTZ? CY/NIJ3N 
THE KW11-Y IS A WATCHDOG TIMER THAT IS CONSTANTLY ATTEMPTING TO 
TIME OUT SYSTEM ACTIVITY. THE RSX-11M/S EXECUTIVE REFRESHES 
THE TIMER AT EVERY CLOCK INTERRUPT. IF THE SYSTEM FAULTS OR A 
HARDWARE FAILURE OCCURS ANID THE TIMER ELAPSES AN EXTERNAL. 
SIGNAL IS GENERATED. 
NO YOU WANT KW11-Y WATCHDOG TIMER SUFFORT? CY/NISN 
THE FDF-11/70 PROVIDES ADNNITIONAL PARITY CHECKING CIRCUITRY. 
THE BUFFER MEMORY <(CACHE) USED TO SPEED UF MAIN MEMORY 
OPERATIONS IS ALSO CAPABLE OF GENERATING ANI CHECKING FARITY. 
DOES THE TARGET PROCESSOR HAVE A CACHE MEMORY? CY/NIiN 

END PROCESSOR OFTIONS. 

BEGIN FERIPHERAL OPTIONS. 


EXPANDED COMMENTS DESIRED FOR FERIFHERAL OF TIONS? CY/NIIN 


SPIF RSXBLO. TMP Ss K/DE 


FIP 


~~ NO SUCH FILE(S) 


aves Cii»LOIRSXBLID. TMP sx 


ago 
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nO YOU WANT DISK WRITECHECK SUPPORT? CY/NILY 

[tO YOU HAVE ANY FROCESS 1/0 OR LABORATORY PERIPHERALS? CY/NIiN 

HOW MANY CM/CRi1 CARD READERS DO YOU HAVE? CD RtO.-16.]2 0 

HOW MANY TA11 DUAL CASSETTES DO YOU HAVE? CFO Ri0.-16-]! 0 

HOW MANY RJ/RWFO4-05-06 DISK CONTROLLERS HAVE YOU? CO R20.-16.7% 1 
NO YOU WANT OFFSET RECOVERY SUPFORT? CY/N13 


OFFSET RECOVERY IS A TECHNIQUE FOR READING DATA IN INSTANCES 
WHERE IT CANNOT OTHERWISE BE RECOVERED. IT INVOLVES MOVING THE 
DISK READ HEAL IN SMALL INCREMENTS ABOUT CYLINDER CENTERLINE IN 
AN ATTEMPT TO FICK UF A STRONGER SIGNAL AND THUS ALLOW TATA TO 
BE RECOVERED. 


NO YOU WANT OFFSET RECOVERY SUPPORT? CY/NIZY 

D0 YOU WANT THE DRIVER TO BE LOADABLE? CY/NI7Y 

ENTER VECTOR ADDR. OF THE NEXT RJ/RWPO4-05-06 CO R260-774 [e254]? 21N1N54 
WHAT IS ITS CSR ADRESS? CO R2160000-177700 03147670073 
HOW MANY DRIVES DOES IT HAVE? CO R31.-8.12 4 

ENTER PHYSICAL UNIT NUMBER OF THE FIRST DRIVE £O D207: 0 
IS THE FIRST DRIVE AN RFO4 OR RPOS? CY/NIEN 

IS THE NEXT DRIVE AN RPO4 OR RFOS? CY/NIIN 

IS THE NEXT DRIVE AN RFO4 OR RPOS? CY/NICY 

IS THE NEXT DRIVE AN RFO4 OR RFOS? CY/NITY 

HOW MANY RF1il DISK CONTROLLERS DO YOU HAVE? CI Rt0O-.-16.]3 
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EXAMPLE SYSGEN 


HOW MANY RKi1 DISK CONTROLLERS DO YOU HAVE? CO R30.-16.33 1 
DO YOU WANT THE DRIVER TO BE LOADABLE? CY/NItY 

ENTER VECTOR ADDRESS OF THE NEXT RK11 CO Ri60-774 0322013 
WHAT IS ITS CSR ANDRESS? CO R2160000-177700 01317740413 

ENTER NUMBER OF RKOSF FIXED PLATTERS CO Rt0-413 

ENTER NUMBER OF RKOS REMOVABLE PLATTERS CII Ri1.-8.]: 4 

HOW MANY RL11 DISK CONTROLLERS 00 YOU HAVE? CD R20.-16.73 

HOW MANY RK611 DISK CONTROLLERS 00 YOU HAVE? CI R20.-16.]33 1 
DO YOU WANT OFFSET RECOVERY SUFFORT? CY/NI?2Y 

NO YOU WANT THE TIRIVER TO BE LOADABLE? CY/NI2Y 

ENTER VECTOR ADDRESS OF THE NEXT RK61i1 CO R260-774 [321033 
WHAT IS ITS CSR ANTRESS? CO R2160000-177700 0217744013 

HOW MANY DRIVES TOES IT HAVE? CO R21.-8.13% 2 

IS THE FIRST DRIVE AN RKO6? CY/NIAZY 

IS THE NEXT DRIVE AN RKO6? CY/NIZY 

HOW MANY RPLI-C/ZE DISK CONTROLLERS 00 YOU HAVE? EI R30.-16.]3 
HOW MANY RWMOS DISK CONTROLLERS 00 YOU HAVE? CO Ri0.-16.33 

HOW MANY RJ/RWSO3-04 DISK CONTROLLERS 00 YOU HAVE? £0 Ri0.-16.]7% 1 
NO YOU WANT THE DRIVER TO BE LOADABLE? CY/NISY 

ENTER VECTOR ADIIRESS OF THE NEXT RJ/RWS03-04 CO Ri60-774 [220413 
WHAT IS ITS CSR ADDRESS? CO R2160000-177700 D217204073 

HOW MANY TIRIVES NOES IT HAVE? CO Ri1.-8.]3 2 

ENTER PHYSICAL UNIT NUMBER OF THE FIRST DRIVE CO D307: 0 

IS THE FIRST DRIVE AN RSOS?P CY/NISN 

IS THE NEXT DRIVE AN RSOS?P CY/NIEN 

HOW MANY TC11 DECTAPE CONTROLLERS 00 YOU HAVE? CO RiQ.-16.]5 1 
NO YOU WANT THE DRIVER TO BE LOATIABLE? [CY/NIZY 

ENTER VECTOR ADMRESS OF THE NEXT TC1i CO Rié60-774 Ds214]: 

WHAT IS ITS CSR ALNRESS? [CO R2160000-177700 Dsi77342d3 

HOW MANY DRTVES NOES IT HAVE? FO Rt1.-8.73 2 

HOW MANY RXii DISK CONTROLLERS DO YOU HAVE? CIE R2O.-16.]3 1 

nO YOU WANT THE DRIVER TO BE LOADABLE? CY/NIZY 

ENTER VECTOR AQIIRESS OF THE NEXT RX11 CO Rié60-774 i264]: 

WHAT IS ITS CSR ANDRESS? CLO R2160000-177700 DSi771707% 

HOW MANY DRIVES NOES IT HAVE? CLO Riin-2a: 2 

nO YOU HAVE A&A VT11l GRAPHICS DISPLAY SUBSYSTEM? CY/NI: 

nO YOU HAVE A VS60 GRAFHICS DISPLAY SUBSYSTEM? CY/NA1¢ 

HOW MANY LP/LS/LVLIL/LAL8O LINE FRINTERS 10 YOU HAVE? EID Ri0.-146.]3 
NO YOU WANT FAST PRINTER SUPFORT? CY/NITCY 

NO YOU WANT THE DRIVER TO BRE LOANABLE? CY/NI:Y 

ENTER VECTOR ADDRESS OF THE NEXT LINE PRINTER CO R240-774 22007! 
WHAT IS ITS CSR ANDRESS? CO R2160000~-177700 031775141: 

IS IT AN LS11lsy LAI8O*s OR LFLI-V/W? CY/NIT: 

IS IT A 132. COLUMN FRINTER? CY/NIUSY 


NO YOU WANT 15. SECONIIS BETWEEN FRINTER NOT REALTY MESSAGES? [LY/NIIN 
HOW MANY SECONDS RETWEEN NOT READY MESSAGES CD R20O.-255. D215.42 45 


HOW MANY TMO2/03 MAGTAFPE CONTROLLERS HAVE YOU? CO R20.-16.3% 1 
TO YOU WANT THE DRIVER TO RE LOADABLE? CY/NI3Y 


1 


ENTER VECTOR ANDRESS OF THE NEXT TJ/TWU/TWE16~-45 [O Rt60-774 22472 


WHAT IS ITS CSR ANMRESS? CO R2160000-177700 [ti172440]3 

HOW MANY IIRIVES TOES IT HAVE? CO Rti.-8,12 2 

ENTER FHYSICAL UNIT NUMBER OF THE TMO2/03 FORMATTER CO fio: 0 
HOW MANY TM/TMA/TMB11 MAGTAPE CONTROLLERS HAVE YOU? CO R20.-16.72 
HOW MANY FC1i FAPER TAFE REANER/FUNCHES [0 YOU HAVE? CI R20.-16.73 
HOW MANY FRIiil FPAFER TAFE READERS DO YOU HAVE? £D R30.-16.73 


INCLUDE CONSOLE IN THE ANSWER TO THE NEXT QUESTION. 


ENTER NUMBER OF DLAi LINE INTERFACES [0 Ri1.-16.72 1 

NO YOU WANT THE TIRTVER TO BE LOADABLE? CY/NIZY 

ENTER VECTOR AQNQRESS OF THE NEXT DL11 CO Ri60-774 0340]; 

WHAT IS ITS CSR ADNRESS? CO Ri160000-177700 21775601; 

ENTER NUMBER OF DHil ASYNCHRONOUS LINE MULTIPLEXERS CY RiO.-16.]¢ 
ENTER TOTAL NUMBER OF TNTAL UF LINES [0 Ri:0O.-48.]3 4 

DO YOU WANT TO ANSWER AT 110 BAUD? CY/NI; 

NO YOU WANT TO ANSWER AT 150 BAUD? CY/NI: 

ENTER TOTAL NUMBER OF LOCAL LINES CI! Ri29.-44.]: 49 

ENTER VECTOR ADDRESS OF THE NEXT DH11 CO Ri300-774]: 310 


3 


EXAMPLE SYSGEN 


7% WHAT IS ITS CSR ANDRESS? CO Ri160010-17770073 160020 

“x ENTER VECTOR ADDRESS OF THE NEXT 0M11-BBR CO R2300-7741]1! 300 

ox WHAT IS ITS CSR ADDRESS? CO R2160000-177700 217050073 

ox ENTER VECTOR ADDRESS OF THE NEXT DH11 CO R3300-77412 320 

> WHAT IS ITS CSR ANDRESS? CO R2160010-1777003? 160040 

2x ENTER VECTOR ADDRESS OF THE NEXT DH11 CO R2300-774133 330 

2% WHAT IS ITS CSR ALDRESS? CO R$160010-177700]3 160060 

“Xx ENTER NUMBER OF [1J11 ASYNCHRONOUS LINE MULTIPLEXERS £0 R:0.-146-.]: 0 
ox ENTER NUMBER OF 012711 ASYNCHRONOUS MULTIFLEXERS Cl R20.-16.73 

2x 10 YOU HAVE ANY INTER-FROCESSOR COMMUNICATION DEVICES? CY/NIIN 


, 
oy END PERIFHERAL OPTIONS. 
*PIFP RSXMC.MAC=011»107RSXMCO.MAC/AF 


2PIP RSXBLID.CMN=RSXBLID. TMP s xX 
SPIP RSXBLID. TMP 9s X/TIE 


END SYSGEN QUERY SECTION 
AT THIS POINT WE RENAME THE ASSEMBLY COMMAND FILE 
A 


NO. THE SYSTEM BUILD) COMMAND FILE TO Clis24] 


IF Ciis247/RE/NV=RSXASM. CMDS Ky RSXBLU. CMG 
nig YOU ANSWER THE SYSGEN QUESTIONS TO YOUR SATISFACTION? CY/NIZY 


IF YOU ARE BUILDING A SPECIALIZED SYSTEM YOU 
MAY WISH TO EXIT THE FILES WHICH ARE PRODUCED 
BY THE QUERY SECTION. 


TO YOU WANT TO EXIT ANY OF THE QUERY SECTION OUTPUT FILES? CY/NIJEN 


‘o> “ar “E> Wr “en E> er JE ~er “C> ~er cm “er JE “Ti “en ~er ~ern “em ~er “Or “E> @ 


NOW WE ASSEMBLE THE EXECUTIVE 


ASSEMBLING THE EXECUTIVE TAKES ANYWHERE FROM 20 MINUTES (ON AN 11/770) 
TO 4 HOURS (ON AN 11704). TAKE A BREAK. 


re So a Sd 


SET /UICH=C11is24)] 
>TIM 

1St25327 16-NHEC-77 
>*MAC @RSXASM 


>TIM 
15139244 16-DEC-77 

4 

=} NOW WE BUILD THE CONCATENATED OBJECT MODULE FILE 
>} FOR THE EXECUTIVE. 

“y 

“PIP RGX.ORS=*. OR 

oPIF RGX11M.OBJ/RE=RSX. OBS 

=} NOW WE COPY THE RUILD COMMAND FILE» THE ASSEMBLY PREFIX 
FILE, THE UDC» DSS OR ICS/ICR FILES ANI) THE CONCATENATED 
ORJECT MODULES TO SECONDARY STORAGE. 

~“GSET /UIC#=L200% 2001 
T /UICHCL» 24) 


im IT} 


“ 


ws 


COFY THE EXECUTIVE ORJECT MODULE FILE» TASK BUILD 
COMMAND FILE AND ult OR ICS/ICR FILES TO THE FROFER 
HIRECTORY. 


wong ns 
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>PIP LES /NV=CL1»247RSXBLI.CMIty RSXIIM.ORJ 
“PIF LEICL200% 200I/NV/UF#C 1191 OIRSXMC.MAC 
“SET /UIC=0200%200] 


EXAMPLE SYSGEN 


-DMO TKO; 


OMS 
> a> “ae “es 


aot 


“ag! 


REMOVE THE EXECSRC DISK FROM IIKO?. BEFORE FROCEEDING TO THE NEXT 
7% FHASE OF SYSGEN» YOU MUST COFY THE SYSTEM DISK» IF YOU HAVEN’T 
“9 DONE SO ALREADY. 

oy 

2k HAVE YOU MADE A COFY OF THE SYSTEM NISK? CY/NIZY 

“ASN DKO2=SY3 

ASN DRI2SL Be 


PUT THE SYSTEM DISK IN DKO? AND START IT UP (WRITE ENABLED). 


"> S> “Gr 


"»K IS THE SYSTEM DISK REANY? CY/NI3Y 
“MOU DROS SYSTEM 


wy 

’) DELETE MAPFED OR UNMAFFED ORJECT LIBRARIES AND BUILD FILES 
ey 

SSET /UTIC#0C1»24] 

SPIP C1 9201. ke K/TE 

SET /UTC#l1954] 

SPIP @LBSL200%200IICOPYTSK 

SFIF /CO=LB? BANSYS.*sTISCSYS. kK» PRESRV.* 


“§ COPY SYSTEM ORJECT ANT RUILD FILES FROM RBASLINE DISK 
of 

“SET /UIC=C1924) 

“PIP /NV=LE3RSXBLO.CMDsRSX11M.0BJ 

SPIF C2007 200I7/NVELBI C2002 200IRSXMC .MAC 

2x 00 YOU WANT TO. CONTINUE WITH THE NEXT PHASE OF SYSGEN? CY/NItN- 


Fase AS 


we 


a a a 


WHEN YOU 10 WANT TO CONTINUEs MOUNT THE BASLINE DISK IN DK1t,s 
THE SYSTEM TNISK IN DUKO%» BOOT THE BASLINE DISK» ASSIGN 
UKO2=SYO%» AND START THE COMMAND FILE SYi£200%200]SYSGEN2.CMD. 


2@ <EOF> 


@DK3C200% 200ISYSGEN2 
“SET /UIC=£200»%2007 


SYSGEN FART 2 “VERSION 03.1% 


9" 


COPYRIGHT (0) 1975» 197469 1977 
DIGITAL EQUIPMENT CORF.» MAYNARD: MASS, 01754 


ey 


af +s 


BUILD THE EXECUTIVE AND ALL REQUIRED TASKS 


we A we 


fw we wow Ww! 
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EXPANDED COMMENTS PROVIDE A DESCRIFTION OF EVERY STEP IN THIS 
SYSGEN2 COMMAND FILE. ON THE OTHER HANDI!y SHORT COMMENTS 
PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 


nO YOU WANT EXPANDED COMMENTS FOR SYSGEN PART 2? CY/NIZY 
2X IN WHICH RKOS UNIT IS THE BASLINE DISK? CO R2O-3]2 1 

2K IN WHICH RKOS UNIT IS THE SYSTEM DISK? CO R:0-372 0 

SASN DKI3=LB? 

“ASN DROS=SY3 

2x HAVE YOU ALREADY BUILT THE EXEC? CY/NI¢N 

SET /UIC=£200% 2007 

PIP LISGEN. CMD K/TIE 


oF 
>$ AG DISTRIBUTEN ON THE OBJECT DISK, THE SYSTEM OBJECT 
>} LIBRARY (SYSLIB) DOES NOT CONTAIN THE FORTRAN RUN TIME 


EXAMPLE: SYSGEN 


Lo 


SYSTEM MODULES FOR THE LFS-11 MODULES» THE PURDUE ISA MOIULES 


we 
“9 FOR THE UNC, NSS11/0RS11 OR ICS SUBSYSTEMS. THEY MUST RE 

“3s ADDED IF YOU PLAN TO USE THESE ROUTINES IN YOUR TARGET SYSTEM. 
°SET /UIC=£1917 

ox T0 YOU WISH TO ANT THE UNC/LPS/ICS/NSS ROUTINES TO SYSLIB? CY/NIEN 
PIP PURISA.OBRJ¢X/NE sPURUIIC §XePURICR§ Ko LPS ke LP ARK 

“SET /UICHC1»247 


oF 

*) DELETE ALL BUT LATEST VERSION OF EXEC BUILD COMMAND FILE» 
2% ASSEMBLY PREFIX FILE» ANDI ALL EXEC ORJECT LIBRARIES IF ANY. 
oy 


2PIPF RSXBLO.CMD/PU 

“PIP RSX1IM.OLBsK/DE 

PIP -~ NO SUCH FILE(S) 
SYOSL 1» 24IRSX11IM-OLBS xX 
“PIF C2007200IRSXMC.MAC/FU 


NOW WE BUILD THE EXEC LIBRARY 


“=> “> «@ 


LER RSX1LIM/CRI80. 2640, 2128.=RSX11M.0BJ 

“PIF RSXLIM.OBI9 k/DE ! DELETE OBJECT MODULE FILE 

“k DO YOU WISH TO ADL USER WRITTEN DRIVER(S) TO THE EXEC? LY/NIIN 
“SET /UIC=C1s24] 

oo 

“o NOW WE BUILD THE EXECUTIVE 

oF 

“TKE @RSXBLOI 

ok DID THE EXECUTIVE BUILD SUCCESSFULLY? CY/NIZY 
oPIF Cly24]ICBLO.CMDs k/DEsUNCBLI.CMIisxk»s ISRLI.CMDs x 
YOU NOW NEED THE MAF OF THE EXECUTIVE TO LAYOUT 
THE FARTITIONS IN YOUR NEW SYSTEM. 


= NO YOU HAVE THE MAF ALREALY? CY/NI3N 
PIF LP2=SYO30C1»34IRSX11M.MAP 


LOOK IN THE MAF OF THE EXEC FOR THE SYMBOL $SYTOF WHICH 
INDICATES THE LAST ADDRESS ALLOCATED TO THE EXEC. USER 
FARTITIONS MAY START AT ANY LOCATION BEYONE THIS ADIIRESS 

AS LONG AS THEY FALL ON A 64 BYTE BOUNDARY. SEE THE 

SYSGEN MANUAL FOR A TIESCRIFTION OF HOW TO SET UF FARTITIONS. 
YOU MAY WISH TO STOF AT THIS TIME TO LAYOUT YOUR FARTITIONS. 
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tO YOU WANT TO CONTINUE ANDI BUILT THE TASKS NOW? CY/NIZY 


WE WILL NOW EMIT THE TASK BUILT COMMAND FILES 
AND BUILD THE REQUIRED TASKS. 


MOST OF THE TASKS TO RE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY EITHER PARTITION 
SYSFAR OR GEN. SYSFAR IS A PARTITION WHICH IS 
ASSUMED TO BE 10000¢8) BYTES LONG 

GEN IS A PARTITION WHICH IS 40000(8) BYTES LONG 


ro a 


*, 
ro 


ET /UICHBC1»24) 
SRIF LAINIT. OLBsx/TE » C2009 200 7BLULAINIT.CMI9 x 


IT IS POSSIBLE TO BUILD 3 VERSIONS OF THE FILE SYSTEM? 

1) 2K NON-MUL.TI-HEADER 

2) 2.5K MULTI-HEATIER 

3) SSK FAST MUL TI-HEANER 
THE NON-MULTI-HEADER FILE SYSTEM RESTRICTS FILES TO A 
MAXIMUM OF 26%112 BLOCKS OF S12 BYTES. THE MULTI-HEADIER 
FILE SYSTEMS TO NOT ENFORCE THIS RESTRICTION. IF YOU 
ARE BUILINING A 16K SYSTEMs YOU MUST ALWAYS BUILD THE 2K 
FCF. FOR SYSTEMS WITH RFO2/03/04/05/06 DISKS IT IS 
RECOMMENDED THAT YOU BUILD THE S.SK FCF. BIGFCF IS 


ro Th oe oi oe 


EXAMPLE SYSGEN 


STRUCTURED SO THAT IT STORES AS MANY FILE CONTROL BLOCKS 
(FCB’S) IN ITS TASK IMAGE AS FOSSIBLE BEFORE OVERFLOWING 
INTO THE DYNAMIC STORAGE REGION. AS DISTRIBUTED, THE 
BUILD) COMMAND FILE ALLOCATES SFACE FOR 24. FCR’S. YOU 
MAY CHANGE THIS LIMIT BY EDITING THE BUILI! COMMAND FILE. 


nO YOU WISH TO BUILT THE BIG (5.5K) AND FASTER FILE SYSTEM? LY/NItY 
PTF FCPNMH.OLBs X»FCPNMHBLD, ks *K/TE 


BIGFCFE’S BUILE FILE SELECTS FARTITION FCFFAR 
WHICH STARTS AT 0(8) ANT IS 

26000(8) LONG. IN MOST CASES» THESE LIMITS WIL 
HAVE TO BE ALTERED FOR YOUR SYSTEM, 


a ed 
af 


ee 


00 YOU HAVE TO EDIT THE S.SK FCF TASK RUILID COMMANID FILE? CY/NI2N 


THE TASKS MCR» MCRMUs ANI! TKTN NORMALLY RUN IN FARTITION 
SYSFAR. IF YOU WISH TO CHANGE THE FARTITION NAME,» 

PUT ANY OF THESE TASKS IN OTHER FARTITIONS» 

OR CHANGE THE LENGTH OF SYSFAR FROM 10000(8), 

YOU MUST EDIT THE TASK BUILI COMMANT FILES. 


ae ye 


ay 


ae yt Cae 


3! 


THERE ARE TWO VERSIONS OF MCR AVAILABLE ~- A SINGLE USER 
VERSION AND A MULTI-USER VERSION. THE SINGLE USER MCR 
FROCESSES ALL COMMANIIS SERIALLY ANID RUNS IN FARTITION 
SYSFAR. THE MULTI-USER VERSION CONSISTS OF TWO TASKS» 
MCRMU AND SYS. TASK MCRMU RECEIVES ALL COMMANIIS IN 

THE NORMAL SERIAL MANNER» BRUT IT FASSES MOST ON TO 

TASK SYS FOR FROCESSING. SINCE MULTIFLE COPIES OF 

SYS MAY BE RUNNING (ONE FOR EACH TERMINAL) A DEGREE 

OF FARALLELISM IS ACHIEVED. TASK MCRMU RUNS IN 
PARTITION SYSPAR WHILE TASK SYS RUNS IN GEN. 


“e 


en ee ee ee Re a ase 
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re 


DO YOU WANT TO BUILY THE MULTI-USER VERSION OF MCR? LY/NI3Y 
SPF MCRBLIV. Ks K/TIE 
ok NO YOU. HAVE TO ELIT THE TASK BUILT FILE FOR MCRMU ANT SYS? LY/NISN 
“*K DO YOU HAVE TO EDIT THE TASK BUILD COMMAND FILE FOR TRIN? CY/NIEN 
=PIF FLIMSGELO.CMDsK»FIIMSG.OLBsKeFLIMSGRLD. ODL x/NE 
SPIF MTA.OLBs Xk» MTABLID. Ks X/DE 
SSET /UIC=C1917 
“FIF FCSMTA.OBJs X/DE 
“SET /UIC#01924] 


THE FOLLOWING TASKS FROCESS ALTITIONAL MCR COMMANTDS ¢ 

ROOs DMO» ATs» INTy INS» LOAy MOUs SAVs UFIty ANIt UNL, 
THEIR TASK BUILD COMMAND FILES SPECIFY PARTITION GEN» WHICH IS 
8K WORDS (COCTAL 40000 BYTES) LONG. IF YOU WISH TO CHANGE THE 
PARTITION IN WHICH ANY OF THEM RUN» YOU MUST EXIT THE 
APPROPRIATE BUILD FILE. 
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IF THE ALTER-FPRIORITY IRECTIVE WAS NOT INCLUDED IN THE 
EXECUTIVE» YOU MUST EXIT THE COMMAND FILE FOR TASK AT. 


NO YOU HAVE TO EIT ANY FILES FOR MCR TASKS? CY/NIIN 


THE TASKS HELLO AND BYE PROVIDE LOGIN/LOGOUT SUPPORT FOR 
MULTI-USER SYSTEMS. IF YOU SELECTED MULTI-USER FROTECTION 
SUPFORT TURING SYSGEN FART 1s YOU MUST BUTLID HELLO AND BYE. 
THE ACCOUNT FILE MAINTENANCE PROGRAM ACNT MUST ALSO RE 
RUILT TO CREATE ANI MAINTAIN THE FASSWORT FILE. IN 
ALUITIONs TWO OFTIONAL UTILITY TASKS ARE AVATLARBLE: 

BRO ~- BROADCAST MESSAGE TO TERMINALS 

SHUTUF ~ FERFORM ORDERLY SYSTEM SHUTDOWN 
ALL OF THE DISTRIBUTED COMMAND FILES SPECIFY THAT THE 
TASKS RUN IN FARTITION GEN. 


nO YOU WANT TO BUILD THE MULTI-USER PROTECTION TASKS? LCY/NICY 
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EXAMPLE SYSGEN 


NO YOU WANT TO BUILD THE MULTI-USER UTILITIES? CY/N 


IF YOUR TARGET SYSTEM DOES NOT HAVE A LINE FRINTER» 
EQNIT THE BUILD FILE FOR ACNT TO REMOVE THE ASST GNME 


DO YOU HAVE TO EDIT THE RUILD FILES FOR HELLO, BYEs 
NO YOU HAVE TO EIT THE BUILD FILES FOR BRO AND SHU 


THE TASKS ERL AND ERF SUPFORT ERROR LOGGING. ERL I 
ERROR LOGGER TASKs ERF TURNS ERROR LOGGING OFF. TH 
BE BUILT IF YOU SELECTED ERROR LOGGING SUFFORT DURI 
PART ONE. THE TASK BUTLID COMMANI! FILES BUILT ROTH 

RUN IN FARTITION GEN. 


THE REMAINING ERROR LOGGING TASKS (PSE AND SYE) ARE 
PRIVILEGED AND THEREFORE ARE NOT BUILT TURING SYSGE 
IF YOU WANT TO BUILT) THESE TASKS» YOU MUST DO SO IN 
FART 3. 


tO YOU HAVE TO EDIT THE BUILD FILES FOR ERL AND ERF 


THE TASK ACS ALLOCATES/DEALLOCATES THE CHECKPOINT F 
IF YOU SELECTED SUPFORT FOR DYNAMIC ALLOCATION OF 
CHECKFOINT SPACE DURING SYSGEN FART i» YOU MUST BUT 
THIS TASK. IT WILL BUILT TO RUN IN FARTITION GEN. 


nO YOU WANT TO BUILD TASK ACS? CY/NITZY 
NO YOU HAVE TQ EDIT TASK ACS’S BUILD COMMAND FILE? 


TASK FMI IS THE FOST-MORTEM AND SNAP DUMP FROCESSOR 
IT IS A PRIVILEGED TASK AND FOR CORRECT OFERATION I 
RUN IN A PARTITION WITH ONLY CHECKPOINTABLE TASKS. 


CONTROLLED. 


nO YOU WANT TO RUILD TASK SHF? LY/NAILY 
nO YOU HAVE TO EIT TASK SHF’S BUILD COMMAND FILE? 


THE TASK RMIEMO DISFLAYS SYSTEM STATUS ON A VTOS OR 
IT DISPLAYS THE ACTIVE TASKs FOOL STATUS» PARTITION 
LAYOUT, ANI! TASKS RESIDENT IN MEMORY. IT WILL BUTLD 
FOR FARTITION GEN BUT ONLY REQUIRES 4K TQ RUN ANT 
USES LUN AS THE DISFLAY DEVICE. 


NO YOU WANT TQ BUILG TASK RMDEMO? CY/NIDY 

ro YOU WANT TO BUILD IT FOR A VTOS? CY/NIEN 

nO YOU WANT TO BUILYG IT FOR A VTS2P LY/NIALY 

PTR RMDOS. ORI) Ke RMDOSBLI. CMDs K/TE 

* DO YOU HAVE TO EDIT TASK RMTMEMQ’S BUILD COMMAND FIL 


THE PRINT SFOOLER IS NOT DISTRIBUTED AS A TASK IMAG 
WISH TO USE A FRINT SFOOLER IN YOUR TARGET SYSTEM» 
EXPLICITLY BUILD IT. THE TASK BUILD COMMAND FILE 
SFECIFIES FARTITION SFLFAR WHICH ITS 10000¢(8) LONG 


NO YOU WANT TO BUILD THE ERROR LOGGING TASKS? CY/NI3 


nef 


YOU MUST 
NT TO LFS. 


AN ACNT? CLY/NIIN 
TURP? LY/SNIIN 


S THE 
EY MUST 


NG SYSGEN 
TASKS TO 


NOT 
N FART 2. 
SYSGEN 


¥ 


? LY/NISN 


ILE. 


Lo 


CY/NI¢N 


T SHOULD 


THE TASK BUILD COMMAND FILE BUILDS THE TASK FOR FARTITION 
FAR4K WHICH TS 20000¢(8) LONG 

DO YOU WANT TO BUILD TASK FMI? CY/NIEN 
TF PMD. OLBs Xs PMDBLI. ke KDE 

TASK SHF IS THE SYSTEM CONTROLLED FARTITION TASK 
COMPACTION ROUTINE. IT WILL AGGLOMERATE FREE SFACE 

IN A SYSTEM CONTROLLED FARTITION ON REQUEST FROM 

THE EXECUTIVE. YOU MUST HAVE SELECTED DYNAMIC MEMORY 
ALLOCATION DURING SYSGEN FART 1 FOR THIS TASK TO BE 
CALLED BY THE EXECUTIVE. IT NORMALLY RUNS IN FARTITION 
SYSPFAR. THE FARTITION IT RUNS IN MUST NOT BE SYSTEM 


LY/NIIN 


VTG2 6 


E? LY/NIIN 


E. IF YOU 
YOU MUST 


EXAMPLE. SYSGEN 


NO YOU WANT TO BUILD TASK PRT (PRINT SPOOLER)? CY/NI3Y 


ee Se 


THE DEFAULT PRINT SRPOOLER WILL ONLY DELETE FILES NAMED 
LF«LSTs LPeMAF» &.PMIly AND X-UMF., IF YOU WANT THE SFOOLER 
TO DELETE ALL FILES» YOU MUST EDIT THE RUILY! COMMAND FILE. 
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“*k TO YOU HAVE TO ELIT TASK FRT’S BUILD COMMAND FILE? CY/NISY 
SENT PRTBLO.CMD 

COO081 LINES READ INI 

CPAGE 1] 

XL FAR 

PAR=SPLPARIO3 10000 

*C/SPLFPAR/GEN 

PAR=GEN30210000 

XEX 

CEXITI 


NOW WE BUILD. THE PRIVILEGED ANT MCR TASKS. 


“a> “@> ed 


SSET /UIC#D1724] 

SPIF OX. CMD/FU 

=k DO YOU WANT TO GENERATE THE MAFS FOR THE ABOVE TASKS? CY/NIIN 
™ASN NLt=MP 3 

>TKE @BOORLD 

>PIF BOO.OLB# x» BOOBLD. CMI x/TE 

=TKE @LIMOBLI 

>PIP DMOBLIN. CMDS X/DE 

=TRB @BIGFCPRLE 

SPIP FCF.OLBSk»FCFBLD. CMI» BIGECPRLD. x9 X/TE 
>TKE @INDELD 

>PIP IND. OLB#k» INDBLI. X9X/TE 

=TKB @INIBLE! 

SPIP INIBLU. Kd X/DIE 

>TKB @INSBLD 

DPIP INS.OLB#x» INSEL. XS X/TE 

=TRE @MCRMUBLDD 

=PIP MCRMUBLI. K# x ySYSBLILOKEK/DE 

>TKB @MOUBLE! 

SPIE MOU.OLES Xs INT. OLBS x» MOUBLID KEK/DE 
=TKR @SAVELD 

SPIE GAV.OLESk»SAVBLI KS X/TIE 

=TRB @TKNELD 

DPIP TRNELDL. CMIGX/DE 

=TKE @UFIUBLD 

SPIP UFD. OLS» UFDBLD. CMIG*/DE 

=TKE @LOABLE! 

*TRE @UNLBLI - 

>PIF LOABLIN CMDS XyUNLBLIN Xs LOA. OLB SK/DE 
STKE @RMDS2BLD 

SPIF RMDS2.OBJ$ ke RMDS2BL DO. CMNEK/TE 
=TKE @SHFEBLD 

>PIP SHUFL. OBIS X» SHFBL I. CMI K/TE 

STKE @PRTBLI 

SPIF PRT. OLES Xo PRTBLI. ODL} Xe PRB. CMI k/DE 
“TKR @ACNTRLD 

>PIP ACNTBLD. $X/TE 

>TKE @BYERLD 

>PIP BYEBLIN. CMDS X/DE 

=TKB @HELBLD 

=PIP HELBLD. CMD $ X/TIE 

=TRKE @BROBLD | 

>PIP BROBLU.CMDSX/DE 

>TKB @SHUTUPBLI! 

>PIP SHUTUPBLD. CMIGX/TIE 

PIP MLTUSR. OBS */DE 

™TKB @ACSBLD 

SPIP ACSBLI. CMDS X/DE 


EXAMPLE SYSGEN 


PIF MCR OLBsSk/TE »SYSROT.ORJ#X 

“TKR @ERFBLID 

*TKB @ERLBLDD 

oPIF ERF.OBJ#X/DEsERL.OL BEX 

*PIF £C200»2001/RE=RSXELO.CMIyRSX11M.OLE 

PIP &.kSK/TE 

SPIP C1924] /RE=C200» 200 IRSXBELU.CMIyRSX11M.0LE 


2& DO YOU WANT TO BUILD ANY LOADABLE DRIVERS NOW? CY/NIZY 


PSET /UIC=£200% 200] 


oe 


*§ YOU MAY NEED THE TASK BUILT MAFS FOR THE DRIVER(S) FOR 


»e YOUR PARTITION LAYOUT. 

oe 

ok TO YOU WANT THE MAPS? CY/NIiN 
SET /UICHC1,24) 


2K WHAT IS THE DRIVER FARTITION NAME CSI: DRVPAR 
?TKE @£200» 2001 TTORVELB 


“PIP C200*200ITTORVBLD,.CMD$3X/DE 
ok WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC CS73 


oe 

>% WHEN ALL DRIVERS ARE BUILT» STRIKE CARRIAGE RETURN WHEN 
2) FOR DEVICE MNEMONIC. 

we 

7% WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC CSJ: OT 
2X WHAT IS THE DRIVER PARTITION NAME CSI? DRVPAR 

oTKE @£200% 200] 0TURVBLI 

SPIF C200» 200] 0TORVBLI. CMDs K/NE 

“& WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC CSI: 0S 
ok WHAT IS THE DRIVER FARTITION NAME [S13 ORVFAR 

*TKE @C200» 200] DSIIRVBLI 

ePIP £2007200 ]0S0RVELD. CMI K/TIE 

2% WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC CSI? DB 
2X WHAT IS THE URIVER FARTITION NAME FSI? DVNUNRYVPAR 

“STKE @£200» 200] DBIRVBLM 

VPIP £2007 200 70B0RVELT «CMI K/TE 

2x WHAT IS THE DRIVER 2~CHARACTER DEVICE MNEMONIC CSI? OK 
> WHAT IS THE DRIVER PARTITION NAME CS1? DIRVFAR 

*TRE @£200% 20070K0RVBL IE 

ePIF £2007 2007 DKURVELO. CMY K/TIE 

°& WHAT IS THE DRIVER 2-CHARACTER NEVICE MNEMONIC (S72 LF 
2 WHAT IS THE DRIVER FARTITION NAME CSI? DRVFAR 

2TRE @L 200% 2007 LFURVBLM 

2PIF £200 2007 LPURVBLE. CMI K/TE 

2k WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC CSJs 0x 
** WHAT IS THE DRIVER FARTITION NAME CS2° DRVPAR 

STKE @£200» 2007 0X0RVBLN 

SPIF 2200+ 2007 DXURVBLI. CMI X/TIE 

2k WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC (Sa? 0M 
2k WHAT IS THE DRIVER PARTITION NAME [S23 URVPAR 

TRE @£2007 200 70MURVEL MD 

DPIF £2002 200 70MURVBLO. CMDs x/DE 

vk WHAT IS THE DRIVER 2-CHARACTER NEVICE MNEMONIC CSI? MM 
2k WHAT IS THE DRIVER PARTITION NAME [S13 TRVFAR 

TRE @L200% 200 MMIRVELD 

2FEIP C2002 200 IMMDRVELD. CMD X/TE 

2 WHAT IS THE DRIVER 2-CHARACTER DEVICE MNEMONIC £0: TT 


“§ RECAUSE UNLOAD WILL RE CONFUSED BY THE NEW LP DRIVER: 
oo WE WILL RENAME TT. BEFORE WE RUN VMR»y WE WILL CHANGE 


oe IT BACK. 

eSET /UICH#01994] 

oPIF LENEW. TSK/NV/RESLEORY, TSN 
SPIP LPNEW.STB/NV/RE@LPORV. STE 


" 
"te 
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oe 


fe 


AND REBUILD THE TASK. 


RUN YOU MUST EXIT THE APPROPRIATE TASK’S BUILD COMMANT 


ASKEL 


; 

* THE UTILITY TASKS (MACs FIFs TKR ETC.) ARE ALREADY BUILT TO RUN 
9 FARTITION GEN (EXCEFT RIGMAC AND BIGTKR WHICH ARE BUILT TO RUN 
2F IN PARI4K). IF YOU WISH TO CHANGE THE FARTITION IN WHICH ANY OF 
; 
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NOTE: 


IF 
ANI 
MEMORY ANI 
SUGGESTEN 
INSTEAD OF 
OTHERWISE » 


THE 


nO YOU WANT 


ANSWER 


TO REBUILE 


YO 


YOU WANT TO REBUILD 
THE SYSTEM YOU ARE 
IT WI. 

THAT YOU RBUTLMD 


R 


BASL.I 
YES 


TO REBUILE UTILITIES 


GET /UTC#£ 2009200] 


Sune NKO? 
et 
REMOVE THE 


Sok IS THE UTILORS 
“MOU DKOSUTILOBS 


THE UTILOBSJ DISK. 


SYSTEM DISK 
START UF 


"> 


NISk 


an HO YOU WANT EXPANDED 


NO YOU WANT TO REBUILD 


no You 


IS SYSLIB ALREADY CORRECT FROM A PREVIOUS RUN OF THIS 


NOTE 


WANT 


FROQUCTS « 


YOUR 


SET /UIC= 


na 
no 
no 
no 
ro 
no 
no 
ng 
rio 
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no 
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=a Man eed 
WANT 
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WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
HAVE 
WANT 
HAVE 
WANT 
WANT 
WANT 
HAVE 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 
WANT 


WANT 


SN NL3=MP 


TO 


THAT THE 


RUTLD 


TASKS 


THEY HAVE 


4) 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 


TO. 


TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TO 
TQ 
TO 
TO 
TO 
TO 
TO 


CONVENTENCE. 


BUTLE 
BUILT 
RUILD 
BUILT 
RUILD 
BUILD 
BUTLY 
BUILD 
BUILD 
BUTLD 
BUILD 
BUTLD 
BRUTLD 
BUILT 
EQIT 

BUTI 


EMIT TASK SYE’S 


BUILD 
RUTLG 
BUTLY 


EQnIT TASK BASS 


BUILD 
RUTLD 
BUTLD 
RUTLM 
BUILD 
BUTLY 
BUILD 
BUILD 
BUILD 
BUILD 
PRINT 


EXAMPLE SYSGEN 


WU HAVE TO BUIL 


UN THE ISTRIR 


NE 


$ 


ISK» 
TO THE 


FROM TINO? A 


THE 


REALTY? CY/NILY 


tl THE 


UTEX 


ANII/OR 


NI 


FOR MAPFED SYSTEMS IT ISN’T NECES 
ANY OF THESE TASKS 
MAY EXPLICITLY SPECIFY THE FARTITION IN 
WHICH THEY RUN AT INSTALL TIME. 


THE USER MODE [ItTAGNOSTICS ARE NOT DISTRIBUTED 
IF YOU WANT THEM» 


Me 


TASKS » 


QUESTION. 
BUILT OTAGNOSTICS? CY/NICY 


UTTLOBI TISK 


SINCE 


COMM 


ANY 


TECy 
BEEN 


TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 


TASK 
TASK 
TASK 


TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
TASK 
THE: 

THE: 


ENTS FOR 


USER MOTE 


VTECs RNO» ANT 


ALTIED 


MAC? CY/NI: 
BIGMAC? CY/NI: 
TRE? CY/NG¢ 
BIGTKB? EY/NIS 
PIF? CY/NI: 
FLX? LY/NAE 
VFY? EY/NAE 
DME? CY/NI¢ 
EOE? LYNE 
SLE? CY/NA3 
LER? CY/NT$ 
TEC? CY/NI: 
VTEC? CY/NA2 
PSE? LY/NILY 
PSE “S 
SYE? LCY/NIDY 
CRE? 
ZAP? 
BAT? 


CY/NAE 
LY/NIAt 
CY/NI? ¥ 


YVMR? 
RNO? 
SREP 
FTE? 
CMF? 
PAT? 
nsec? 


EY/NI3 
KY/NI3 
LY/NIE 
LY/NI¢ 
Y/N 
KY/NIt 
Y/N 
ClA? CY/NI3 
ET? CY/NIt 
RMS UTILITIES 


MAFS FOR THE UTILITY TASKS? 


SYSGEN FART 
ANY UTILITY TASKS? CY/NALY 
NIAGNOSTICS? CY/NITY 


SRI 


BUILD COMMAND FILE? 


BULLI COMMAND FILE? 


CY/NAE 


SARY 
YOU 


AS TASK IMAGES. 


THE UTILITY OR DYLAGNOSTIC TASKS 
GENERATING HAS AT LEAST 24K OF 


IT IS 


THEM USING YOUR SYSTEM INTSK 
AFTER SYSGEN2 IS COMPLETED, 
FOLLOWING 


REPLACE IT WITH 


(WRITE ENABLED). 


3? CY/NISN 


rIter 


ARE NOT SUPPORTED 
TO THE SYSGEN3 FROCEDURE FOR 


BUILO COMMAND FILE? DCY/NIIN 


CY/NIEN 


DY/SNIEN 


+ 


CY/NI3 


DY/NISY 


EXAMPLE SYSGEN 


sSET /UIC#C1r203 

*x TO YOU HAVE AN EMF TY RKOS REMOVARLE DRIVE AVAILABLE? LY/NIIN 
“TKR @C1i»24I]PSEBLU 

SPIF DKLGt£ is S547/NV201*954FSE.TSK 

“kk WAS PSE COPIED SUCCESSFULLY? CY/NILY 

SPIF CisS4]PSE.TSK30O/DE 

*TKE @€1°24]SYEBLN 

SPIF DKLt€C1 ys 547/NVeC1 es S4ISYE.TSK 

»*k WAS SYE COPIED SUCCESSFULLY? CY/NILY 

oPIF CivsS41SYE.TSKIO/TE 

=TKE @Ci» 247 RADELIM 

“PIF OWLS Cis S47/NVel i» S47 BAD. TSK 

* WAS BAD COPIED SUCCESSFULLY? CY/NIZY 

SPIF CisS4 7 BAD. TSKIO/DE 

>* DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? CY/NI? 
“GET /UIC#019243 

»3 IF YOU HAVE THE DUAL RKOS RELEASE KIT» YOU SHOULID SFECIFY. 

THAT THE DIAGNOSTICS BE STORED ON ANOTHER DISK. IF YOU HAVE 

A THIRI RKOS FUT THE SYSTEM DLISK IN IT ANI! STORE THE DIAGNOSTICS 
ON IT. OTHERWISE STORE THEM ON LBO. 


ard 


aes 


NO YOU WANT THE NIAGNOSTICS STORED ON ANOTHER DISK? CY/NICY 
ENTER THE OUTPUT DEVICE NAME ANT UNIT NUMBER CE.G. UNI) CSI: LRO 


THE COMMANT RUILE FILE WILL NOW FAUSE WHILE YOU MOUNT LBRO? 
YOU MUST CREATE THE UFD’S £12347 AND [12549 ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILT MAPS) IF THEY 
NO NOT ALREADY EXIST. 


a a a a Ta a Si ee 
“S> a> “ap ren “€> “sp JE BE ~a> wer <a> <a> “a> 


AT. ~~ FPAUSING. TO CONTINUE TYPE "RES .++AT+" 
RES «+ +ATs 


AT. -- CONTINUING 


NO YOU WANT TO ALTER THE TiEFAULT PARTITION ATTRIBUTES? CY/NIIN 
ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S73 

DO YOU WANT TASK BUILT MAPS? EY/N1? 

DO YOU WANT TO BUILD ALL AVATLABLE DIAGNOSTICS? CLY/NI3 

HAVE ALL. QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? LY/NItY 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILT: ONE AT 
A TIME. WHEN TONE» ENTER A SINGLE CARRIAGE RETURN. 


Sof ag Me 


wer ~e> es 9G 3 ar er er er 3 EH HE HK : 


NAME CS7$ RKOS 
NAME [ESI3 


NOW WE TASK BUILD THE SELECTED NIAGNOSTICS 


“TK @UMDBLD 
“SET /UIC#C11541 
“DMO DKOE 


REMOVE THE UTILOBJ DISK FROM DKO: ANI REPLACE IT WITH 
THE SYSTEM TISK. 


IS THE SYSTEM DISK READY? CY/NIZY 
OU DKO?SYSTEM 


%, 
ros 


WE WILL NOW COFY THE NEW TASKS TO THE SYSTEM DISK. 
>PIP @LBI £200» 2001 COFPYNEW 

PIP @LBS C200» 2001CORPYNTAG 

“SET /UIC#C1954] 


ser a> er “K BE a> ~e> “> “o>? ~« 


“Fy , 
>% YOU NOW MUST SPECIFY WHETHER THE MEMORY SIZE WHICH YOU 
>>) SPECIFIED FOR YOUR TARGET SYSTEM IN SGN DURING SYSGEN 


EXAMPLE SYSGEN 


FHASE ONE IS GREATER THAN 32K WORDS. 


ae 


ses “E> “E> “E> en “O> “em “en “Ed “E> “E> rap “ED “E> “E> “ED ~er “ar “er “c> Er BE “E> “ar “er “E> a> “E> “E> <a> “ED E> en “ED “E> 3G a> er 


IS YOUR TARGET SYSTEM LARGER THAN 32K WORDS? CY/NI7Y 


IF YOU EVER WISH TO FIX TASKS ABOVE 32K OR LOAD DRIVERS 
ABOVE 32K AND SAVE THE SYSTEM OR IF THE TASK SAV 

(WHICH NORMALLY RUNS IN GEN) IS EVER TO RE RUN AROVE 
32K» YOU MUST CREATE A LARGER COPY OF YOUR TARGET SYSTEM 
WITH FIF AT THIS TIME. 


nf ee ae as 


ae oe? 


* 


NOTE? IT IS NOT FOSSIBLE TO BOOT A VIRGIN MAPPED 
SYSTEM WHICH HAS DRIVERS LOANED ABOVE 27.5K FROM 
AN UNMAFFED SYSTEM. IT IS» HOWEVER» POSSIBLE TO 
BOOT A SAVED MAFFEL SYSTEM WITH ANY CONFIGURATION 
FROM ANY UNMAFFED SYSTEM. 


i i a ee 


no YOU WISH TO CREATE A LARGER COPY OF YOUR SYSTEM? CY/NISY 


TO CREATE A SYSTEM IMAGE IN WHICH TASK IMAGES MAY BE FIXED UF 
TO M K WORTISs OR IN WHICH THE TOF. OF SAV MAY BE AS HIGH 

AS MK WORTIS»s YOU MAY CALCULATE THE NUMBER OF BLOCKS (N) 
NEEDED AS FOLLOWS: 


N= (4M) +2 


af et NS PP A A EE A ee oe 


FOR EXAMPLE A 40K SYSTEM WOULD USE (40.%4)+2=162. BLOCKS 


“y 


NOTE? SAVED IMAGES ON THE 11/770 ARE CURRENTLY 
SUPPORTED ONLY TO A MAXIMUM OF 124K WORDS 
(T.E. N=498.). ALSO» THE NUMBER OF BLOCKS 
IS ASSUMED TO BE OCTAL. TO SFECIFY A 
DECIMAL NUMBER» APPENT A TRAILING DECIMAL FOINT. 


a ee 


v 


FOR SINGLE RKOS DISTRIBUTION KITS» THE 
MAXIMUM SYSTEM IMAGE SIZE IS 64K (258. 
BLOCKS) DUE TO A LACK OF CONTIGUOUS SFACE. 


ox ENTER THE NUMBER OF BLOCKS FOR YOUR SYSTEM IMAGE FILE (CSI: 498. 


“PIF RSX11M.SYS/CO/NV/BL 2 498.=RSX11M. TSK 
SSET /UIC#C1954] 


RSX11M.TSK IS A BACKUP COPY OF THE EXECUTIVE YOU JUST BUILT. 
IF YOU DQ NOT WISH TO RETAIN ITy WE WILL DELETE IT NOW. 


"? 


JE we er “a> “er 


UO YOU WISH TO NELETE THE SYSTEM BACKUP FILE RGXLIM.- TSK? CY/NISYNY 


YOUR TARGET SYSTEM IS NOW READY TO SET UF PARTITIONS ANI! INSTALL. 
THE REQUIRED TASKS. THE FROCEDURE TO FOLLOW ONCE VIRTUAL MCR 
IS RUNNING IS: 
1) EXTEND FOOL SPACE TO BASE OF FIRST FARTITION 
2) SET UP YOUR FARTITIONS 
’$) INVOKE THE INDIRECT FILE INSTALL .CMD IN VMR TO 
INSTALL THE FRIVILEGED TASKS YOU JUST BUILT 
4) LOAD ANY LOADABLE IIRIVERS THAT YOU WANT RESIDENT 
IN THE SYSTEM IMAGE. IF THE TERMINAL ANTI/OR SYSTEM 
DISK DRIVERS ARE LOADABLE» THEY MUST BE LOADED USING 
ws) ae EROM VIRTUAL MCR ANI ROOT IN YOUR TARGET SYSTEM 


we 


ee we 
a ’ s 


cae as fe 


ou ww ee oe 


ae ~e ee SF ae wwe “ .X . . =. 
a> “ar “a> “E> “> sen “E> “CP “Ed <*> ~ap “E> “E> “SP “Hd “EP “CDP “EP “Hr “ED “a> “er 


SET UF THE TARGET SYSTEM BASED ON THE FOLLOWING EXAMPLE. 


=RUN $UMR¥~1 ! RUN VIRTUAL MCR ron ; 
ENTER FILENAME?RSX1LIM.SYS ! VMR PROMPTS FOR FILE NAME. 
VMR=SET /FOOL=340 1 EXTEND POOL TO FIRST FAR. BASE 


UMRESET /MALIN=DIRVPAR? 3402403 TASK |! SET UF DRIVER PAR. 
UMRESET /MAIN=FARL4K 24003 700i TASK ! SET UF 14K FARTITION 


VMR>LO 
VMR="Z 


ENT OF VMR 


THIS S 


AFTER 
INSTAL. 


‘ a 
BEN RE ORE es NE ‘! " ‘ s ‘! ‘ ’ 5 ‘s 
Tt % “> “E> “E> > “G> “Eh “Ed sap “SD “SP “EP serv “SP “GS “EP “E>? ~4> “SP “EP ED “SP “SP “SP Grp “SP 


nT 


NOW WE WILL. 
YOUR SYSTEM 


ae ae eS NS 
“S> “Erp “Gr “Er 


SASN SY3=LE? 
“VMK 


ENTER FILENAME 


A DT: 


EXAMPLE 


YSGEN» 


TARGET SYSTEMS» 
AND NON-FRIVILEGED 
BOOT THE NEW SYSTEM IMMEDIATELY 


EXAMPLE SYSGEN 


VMR>@0200% 2007 INSTALL 


VMR>SET /SUB=FARL4K GEN 4003 400 ! SET UP 8K PARTITION 
VUMR=SET /MAIN=SYSFARI130031002 TASK ! SET UP SYSTEM FARTITION 


‘LOAD DECTAPE DIRIVER 


EXIT FROM VIRTUAL MCR 


THE FILE C200*/2007INSTALL.CMD. CONTAINS COMMANIDS 
TO INSTALL ALL THE PRIVILEGED TASKS THAT YOU BUILT 
IN YOUR TARGET SYSTEM. 
YOU MAY WISH TO EDIT INSTALL.CMD TO INCLUDE OTHER TASKS. 
NOTE ~ IF YOU INSTALL A TASK 
WITH VMR THAT WAS NOT BUILT DURING 


YOU CANNOT RUN THAT TASK 


ANT 


IN THE CURRENT SYSTEM! 
THIS IS TRUE FOR BOTH MAPPED AND UNMAPPED 
FOR BOTH PRIVILEGED 


TASKS + 


THEREFORE » 


SYSGEN HAS FINISHED, OR AVOIL 
LING TASKS WITH YVMR THAT WERE 


NOT BUILT TURING THIS SYSGEN. 


; NO YOU WANT TO ELIT INSTALL.CMD? CY/NIIN 
“PIF LPORY, TSK/RE/NV=LFNEW. TSK 
oPIF LPORV.STB/RE/NV=LFNEW.STEB 


RUN VIRTUAL MCR SO THAT YOU MAY INITIALIZE 


¢ 


$ RSX11M 
VMR=SET /FOOL=700 
VMR=SET /MAIN=DRVFAR? 7002 2602SYS 


VMR=SET /MAIN=SYSFAR? 11602100: TASK 
VMR=SET /MAIN=FCPPARS 126032603 TASK 
VMR=SET /MAIN=GEN? L6\6\5402300073SYS 


VUMRFAR 
LOR 000000 
IIRVFAR 070000 
SYSFAR 116000 
FCPFPAR 126000 
GEN 154000 
VMR=LOA DBS 
VARSLOA DNS 
VMRFLOA TT? 


VMR=@0200%2001 


VMR=FAR 

LOR 000000 

TIRVFAR 070000 
070000 
072000 
073000 

SYSFAR 116000 

FCFFAR 126000 

GEN 154000 

VMR= TAS 

¢ LOR, 

TKTN 03.7 

+o 6 TIMO O34 

eo eMCR OF 

oe eMOU 03,02 

+6 ¢SYS OL 


000000 
026000 
010000 
024000 
300000 


INSTALL 


000000 
0246000 
002000 
001000 
010100 
010000 
026000 
300000 


L. LiFe 
SYSFAR 
GEN 
SYSFAR 
GEN 
GEN 


MAIN 
MAIN 
MAIN 
MAIN 
MAIN 


MAIN 
MAIN 
SUE 
SUB 
SUB 
MAIN 
MAIN 
MAIN 


248. 
248, 
140. 
140¢ 
1 40 + 
160 ¢ 


TASK 
SYS 
TASK 
TASK 
SYS 


TASK 
SYS 
RIVER 
NRIVER 
DRIVER 
TASK 
TASK 
SYS 


000000 
010000 
040000 
010000 
040000 
010000 


LEOF-00000000 FIXEN 
LRO?-00001342 
LBOJ-QQO0O1L 331 
LBRO? ~O0003624 
LBO3~00003402 
LBRO? -00007506 


EXAMPLE SYSGEN 


FLLACP M0235 FCPFAR 149, 026000 LRO?-00004532 


SHF +++ O83 SYSPAR 105. 010000 LBO?-00003330 
eeeINI 03 GEN 100, 040000 LBO?-00003450 
eeeINS 03 GEN 100. 040000 LBOt-00003505 
++ eSAV 03.9 GEN 100. 040000 LBOT~00003706 
e+ eUFI VO407 GEN 100. 040000 LBO?-00003277 
e+eATs 04417 GEN 65+ 040000 LBO?-00007412 
e+ eERF OL GEN dil. 040000 LBOt-00001324 
0+ ACS O1 GEN O+ 9040000 LEO?-00003364 
e+ +HOO 03.2 GEN YO. 040000 LBRO? -00003570 
ERRLOG O1 GEN 30+ 040000 LRO?-00004110 
e+eLOA 03 GEN JO. 040000 LBO?-00003737 
ee eUNL O2 GEN 90+ 040000 LEO?-00003540 
VAR" Z 

*~§ WHEN THE INDIRECT FILE EXITS, BOOT IN YOUR TARGET SYSTEM, 


SET THE DATE AND TIME» ANI SAVE THE SYSTEM WITH A BROOTSTRAF. 
WHEN YOUR SYSTEM REROOTS ITSELF», FURGE THE OLID) TASK FILES. 


“et 


CS 


a ro 


E.+G- 
“BOO RSX11M 


RSX11M VO3.1 BL22 
2TIM 12200200 1-JAN-78 
SAV /WE 


oe Po ae ae 


a To oe Pe Yo a So 


RSX11M VO3.1 BL22 64K MAFFET 
SRED DKOS=SY3 
SRET KOS =L BE 
=MOU TIKOS SYSTEM 
*@0C1»2ISTARTUFP 
> FLEASE ENTER TIME AND TATE CHRIMN DLI-MMM-YY) CSI: 
STIM 12201 1-JAN-78 
*@ “EOF 
SET /UTC=01%54] 
*RUN $FIF 
PIPE ex/FU 
PIPES Z 


DON’T FORGET TO CREATE ACCOUNTS AFTER SAVING YOUR SYSTEM 


tS ep “E> “E> “E> “Gd “E> “> “HP SD “ES samp “Ed “Eb “EP “ED “Eh “AP “SD SP GP “Sr “GP “EP “EP “arp sen “Ed SP Sd 


EOF > 
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ABORT command, 4-26 
ACPs, 
multiple, 4-26. 
Address symbol, 
SSYTOP, 2-4, 4-8 
Allocation, 
dynamic checkpoint space, 
4-21 
file control block, 4-15 
ALT command, 5-8 
Alter priority directive, 
5-8 
ASN command, 3-2, 5-9 
Assembly prefix file, 
RSXMC.MAC, 2-3, 6-2 


Baseline system, 
bootstrapping the, 2-21 . 
BLDDRV.CMD indirect command 
file, 3-91 
BLDUMD.CMD indirect command 
file, 3-111 
Block transfer speed 
optimization, 4-25 
BOOT command, 2-21, 4-12, 
Bootstrapping, 
a write-locked disk, B-1> 
the Baseline system, 2-21 


Checkpoint space allocation, 
dynamic, 4-1, 4-21 
Checkpointable task, 
installing, 4-21 
Checkpointing, 4-5 
Command, 
ABORT, 4-26 
ASN, 3-2, 4-12 
BOOT, 2-21, 4-12, 4-13 
INSTALL /INC, 4-3 
INSTALL /PRI, 4-28 
MOUNT. /ACP, 4-2 
SAV /WB, 4-12 
SAVE, 1-4 ; 
SET, 4-16 
SET /MAXEXT, 4-1 
SET /SYSUIC, 4-13 
VMR commands, 5-1 
VMR SAV, 2-23, 5-37 
Command descriptions, 
VMR, 5-8 
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Command file, 
BLDDRV.CMD indirect, 3-91 


BLDUMD.CMD indirect, 3-111 
COPSY1.CMD indirect, 6-1 
COPSY2.CMD indirect, 6-1 


INSTALL.CMD indirect, 6- 
PRESGN1.CMD indirect, 3 
PRESYSGEN.CMD indirect, 
RSXASM.CMD indirect, 1-3 . 
RSXBLD.CMD indirect, 1l- 3 
RSXMC.CMD indirect, 1-3 
SYSGEN.CMD indirect, 1l- 2 
SYSGENO. CMD indirect; 3-8 
SYSGEN2.CMD indirect, 1-2, 

3-70 . 
SYSGEN3.CMD indirect, 1-2, 
3-98 
Command summary,. 
VMR, 5-1 

Commands, 

VMR informational, 5-1 
VMR initialization, 5-1 
VMR task control, 5-2 _ 

Commands, VMR, 
ALT, 5-8 
ASN, 5-9 
CAN, 5-11 
DEV, 5-12 
FIX, 5-14 
INS, 5-15 
LOA, 5-22 
LUN, 5-26 
PAR, 5-27 
REA, 5-29 
RED, 5-30 
REM, 5-32 
RUN, 5-33 
SAV, 5-37 
SET, 5-39 
TAS, 5-51 
TIM, 5-53 
UNF, 5-54 
UNL, 5-55 

Comments, 

VMR, 5-5 
Common blocks,. 
installing, 4-15 
Compaction, 
memory, 4-6 
Converting V03 system to 
V03.1, 6-1 

COPSY1.CMD indirect command 
file, 6-1 

COPSY2.CMD indirect command 
file, 6-1 
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Devices, 


building systems for other, 


4-11 
Dialogue, 
SYSGEN, 3-1 
Directive, — 
alter priority, 4-27 
Disk, | 
bootstrapping a write- 
locked, B-1 
Disk, 
formatting, 2-27 
Swapping, 4-22, 4-28 
Distribution kit, 
dual RKO5, 2-9 
RK06, 2-17 
RLO1, 2-13 
RP, 2-17 
Single RK05, 2-1 
Distribution kit, details, 
dual RKO5, 2-11 
RKO06, 2-18 
RLO1, 2-14 
RP, 2-18 
Single RK05, 2-3 
Distribution kit, summary, 
dual RKO5, 2-9 
RKO06, 2-16 
RLO1, 2-13 
RP, 2-17 
Single RK05, 2-1 
Distribution kits, 
Saving, 2-22, 2-23 
Drivers, 
loadable, 4-1 
resident, 4-1 
DSC utility, 2-23, 2-26 
exiting from, 2-27 
Dynamic checkpoint space 
allocation, 4-24 : 
Dynamic memory, B-l 
FCP requirements, 4-14 


Error messages, 
SYSGEN, 3-116 
VMR, 5-7 
Example SYSGEN, D-1 > 
Extension, task, 4-25 


FCP, 
dynamic memory require- 
ments, 4-14 
LRU list, 4-15 
FCS resident library, 4-18 
File control block 
allocation, 4-15 
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File control primitive 
requirements, 4-14 
File naming conventions, — 

A-3 
File specification, 
VMR, 5-4 
Formatting disks, oe 27 
FORTRAN resident library, 
4-16 


I/O packets, 4-25 
ICTAB.MAC, 1-3 
/IM switch, 
VMR, 5-4 
Indirect command file, 
see Command file 
INSTALL /INC command, 4-3, 
5-16 
INSTALL /PRI command, 4-28, 
5-17 
INSTALL. CMD, | 
indirect command file, 6-2 
Installing checkpointable 
task, 4-21 
Installing common Hiocks:, 
4-15 
Installing non-checkpointable 
task, 4-21 


Installing resident libraries, 


4-15 


Keywords, 
VMR, 5-5 
KT11 memory management unit, 
1-5 
KW11-Y watchdog timer, B-5. 


Least~recently-used (LRU) 
list for FCP, 4-14 
Libraries, installing resi- 

dent, 4-15 
Library, . 

FCS resident, 4-18 
FORTRAN resident, 4-16 
List for FCP, 
least-recently-used (LRU), 

4-14 
Load device address, 2-27 
Loadable drivers, 4-1, 4-7 
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Magtape distribution: kit, 
dual RKO5, 2-10 
RK06, 2-17 
RLO1, 2-14 
RP, 2-17 
Single RKO5, 2-3 
Magtape distribution kit, 
details, 
dual RKO5, 2-11 
RK06, 2-18 
RLO1, 2-14 
RP, 2-18 
Single RKO5, 2-3 
Magtape distribution. ai 
summary, 
dual RKO5, 2-11 
RK06, -2-18 
RLO1,. 2-14 
RP, 2-18 
single RKO5, 2-3 
Mapped and unmapped systems, 
1-5 
Mapped system, 4-10 
MCR, virtual, 1-4 
Memory, dynamic, B-l 
Memory compaction, 4-6 
Memory management unit, 
KT1l1, 1-5 
Memory partitions, defining, 
4-] 
Memory requirements, 
FCP dynamic, 4-14 
Memory Support, parity, B-4 
MOUNT /ACP command, 4-2 
Multi-user protection, 4-3, 
4-27 
Multi-user system, 4-3, 4-20 
Multiple ACPs, 4-27 


Naming conventions, file, A-3 
Noncheckpointable tasks, 
installing, 4-21 


Optimization, 
block transfer speed, 4-25 
Optional tasks, 4-3 


Packets, I/O, 4-25 
Parity memory support, B-4 
Partitions, 1-4 

defining memory, 4-1 


system-controlled, 4-4, 4-11, 


4-20, 4-21, 4-22 
user-controlled, 4-4 


- PRESRV utility, 


exiting from, 2-27 — 
Print spooler, 4-19 
Priority directive, . 

alter,. 4-27, 5-8 - 
PRT task, 4-19. 


QIO speed optimization, 4-25 


/RC switch, 2-20 
Resident drivers, 4-1 | 
Resident libraries, 
installing, 4-15. 
Resident library, 
FCS, 4-18 
FORTRAN, 4-16 
RMDEMO, C-1 
Round-robin scheduling, 4-23, 
4-28 
RSXASM.CMD indirect. ‘command 
file, 1-3 
RSXBLD.CMD indirect command 
file, 1-3 — 
RSXMC.CMD indirect command 
file, 2-3 


SAV command, 
VMR, 2-23 
SAV /WB command, 4-12 
Saving space, B-4 
Schedule requests, 4-26 
Scheduling, round-robin, 
4-23, 4-28 
SET command, 4-16 
/MAXEXT, 4-1 
/SYSUIC, 4-13 
SGN error messages, 3-116 
Shuffler task, 4-6 
Slave tasks, 4-27 
Speed optimization, 
block transfer, 4-26 
QIO, 4-25 
Starting VMR, 5-2 
SYSGEN dialogue, 3-1 
SYSGEN example, D-1l 
SYSGEN.CMD indirect command 
file, 1-2, 3-2 
SYSGEN2.CMD indirect .command 
file, 1-2, 3-70 
SYSGEN3.CMD indirect command 
file, 1-2, 3-98 
SYSTB.MAC, 1-3 
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System, 


bootstrapping the bagel ines 2-27 


mapped, 4-10. 
multi-user, 4-3, 
unmapped, 4-8 - 
System-controlled partition, 
4-4, 4-6, 4-20, 4-22 
Systems, 
mapped and unmapped, 1-5 
Systems for other devices, 
building, 4-11 
SSYTOP address symbol, 1-4, 
4-8, 4-10 


4-20 


Task extension, 4-24 
Tasks, 
building and installing, 1-4 
installing checkpointable, 4-21 
installing non-checkpoint- 
able, 4-21 
optional, 4-3 
PRT, 4-19 ; 
shuffler, 4-6 
Slave, 4-27 
Terminal input wait, 4-24 
Throughput, increasing, 4-14 
Timer, KW11-Y watchdog, B-5 ~ 


UIC conventions, A-1l 

Unmapped system, 1-5, 4-8 _— 

User-controlled partition, 
4-4 


VFY program, 2-20 

Virtual MCR, 1-4 

VMR, 5-1 
command descriptions, 5-8 
command summary, 5-1 
comments, 5-5 
error messages, 5-7 
file specification, 5-4 
/IM switch, 5-4 . 
information commands, 5-1 
initialization commands, 

5-1 

initiating, 5-2 
keywords, 5-5 
task control commands, 5-2 


Watchdog timer, KW11-Y, B-5 
/WB switch, 1-4 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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Non-programmer interested in computer concepts and capabilities 
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